La version 5 (V5) du Outils AWS pour PowerShell est sortie \$1
Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la [rubrique relative à la migration](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples d'Auto Scaling utilisant Tools for PowerShell V5
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la Outils AWS pour PowerShell V5 avec Auto Scaling.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `Add-ASLoadBalancer`
L'exemple de code suivant montre comment utiliser`Add-ASLoadBalancer`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple attache l’équilibreur de charge spécifié au groupe Auto Scaling spécifié.**
```
Add-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [AttachLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Complete-ASLifecycleAction`
L'exemple de code suivant montre comment utiliser`Complete-ASLifecycleAction`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple complète l’action du cycle de vie spécifiée.**
```
Complete-ASLifecycleAction -LifecycleHookName myLifecycleHook -AutoScalingGroupName my-asg -LifecycleActionResult CONTINUE -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Pour plus de détails sur l'API, reportez-vous [CompleteLifecycleAction](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Disable-ASMetricsCollection`
L'exemple de code suivant montre comment utiliser`Disable-ASMetricsCollection`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple désactive la surveillance des métriques spécifiées pour le groupe Auto Scaling spécifié.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg -Metric @("GroupMinSize", "GroupMaxSize")
```
**Exemple 2 : cet exemple désactive la surveillance de toutes les métriques pour le groupe Auto Scaling spécifié.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [DisableMetricsCollection](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Dismount-ASInstance`
L'exemple de code suivant montre comment utiliser`Dismount-ASInstance`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple détache l’instance spécifiée du groupe Auto Scaling spécifié et réduit la capacité souhaitée afin qu’Auto Scaling ne lance pas d’instance de remplacement.**
```
Dismount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Sortie** :
```
ActivityId : 06733445-ce94-4039-be1b-b9f1866e276e
AutoScalingGroupName : my-asg
Cause : At 2015-11-20T22:34:59Z instance i-93633f9b was detached in response to a user request, shrinking
the capacity from 2 to 1.
Description : Detaching EC2 instance: i-93633f9b
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 50
StartTime : 11/20/2015 2:34:59 PM
StatusCode : InProgress
StatusMessage :
```
**Exemple 2 : cet exemple détache l’instance spécifiée du groupe Auto Scaling spécifié sans réduire la capacité souhaitée. Auto Scaling lance une instance de remplacement.**
```
Dismount-ASInstance -InstanceId i-7bf746a2 -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Sortie** :
```
ActivityId : f43a3cd4-d38c-4af7-9fe0-d76ec2307b6d
AutoScalingGroupName : my-asg
Cause : At 2015-11-20T22:34:59Z instance i-7bf746a2 was detached in response to a user request.
Description : Detaching EC2 instance: i-7bf746a2
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 50
StartTime : 11/20/2015 2:34:59 PM
StatusCode : InProgress
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [DetachInstances](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Dismount-ASLoadBalancer`
L'exemple de code suivant montre comment utiliser`Dismount-ASLoadBalancer`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple détache l’équilibreur de charge spécifié du groupe Auto Scaling spécifié.**
```
Dismount-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [DetachLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Enable-ASMetricsCollection`
L'exemple de code suivant montre comment utiliser`Enable-ASMetricsCollection`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple active la surveillance des métriques spécifiées pour le groupe Auto Scaling spécifié.**
```
Enable-ASMetricsCollection -Metric @("GroupMinSize", "GroupMaxSize") -AutoScalingGroupName my-asg -Granularity 1Minute
```
**Exemple 2 : cet exemple active la surveillance de toutes les métriques pour le groupe Auto Scaling spécifié.**
```
Enable-ASMetricsCollection -AutoScalingGroupName my-asg -Granularity 1Minute
```
+ Pour plus de détails sur l'API, reportez-vous [EnableMetricsCollection](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Enter-ASStandby`
L'exemple de code suivant montre comment utiliser`Enter-ASStandby`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met l’instance spécifiée en mode veille et réduit la capacité souhaitée afin qu’Auto Scaling ne lance pas d’instance de remplacement.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Sortie** :
```
ActivityId : e36a5a54-ced6-4df8-bd19-708e2a59a649
AutoScalingGroupName : my-asg
Cause : At 2015-11-22T15:48:06Z instance i-95b8484f was moved to standby in response to a user request,
shrinking the capacity from 2 to 1.
Description : Moving EC2 instance to Standby: i-95b8484f
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 50
StartTime : 11/22/2015 7:48:06 AM
StatusCode : InProgress
StatusMessage :
```
**Exemple 2 : cet exemple met l’instance spécifiée en mode veille sans diminuer la capacité souhaitée. Auto Scaling lance une instance de remplacement.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Sortie** :
```
ActivityId : e36a5a54-ced6-4df8-bd19-708e2a59a649
AutoScalingGroupName : my-asg
Cause : At 2015-11-22T15:48:06Z instance i-95b8484f was moved to standby in response to a user request.
Description : Moving EC2 instance to Standby: i-95b8484f
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 50
StartTime : 11/22/2015 7:48:06 AM
StatusCode : InProgress
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [EnterStandby](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Exit-ASStandby`
L'exemple de code suivant montre comment utiliser`Exit-ASStandby`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple fait sortir l’instance spécifiée du mode veille.**
```
Exit-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
**Sortie** :
```
ActivityId : 1833d3e8-e32f-454e-b731-0670ad4c6934
AutoScalingGroupName : my-asg
Cause : At 2015-11-22T15:51:21Z instance i-95b8484f was moved out of standby in response to a user
request, increasing the capacity from 1 to 2.
Description : Moving EC2 instance out of Standby: i-95b8484f
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 30
StartTime : 11/22/2015 7:51:21 AM
StatusCode : PreInService
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [ExitStandby](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASAccountLimit`
L'exemple de code suivant montre comment utiliser`Get-ASAccountLimit`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple décrit les limites de ressources Auto Scaling pour votre AWS compte.**
```
Get-ASAccountLimit
```
**Sortie** :
```
MaxNumberOfAutoScalingGroups : 20
MaxNumberOfLaunchConfigurations : 100
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAccountLimits](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASAdjustmentType`
L'exemple de code suivant montre comment utiliser`Get-ASAdjustmentType`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit les types de réglage qui sont pris en charge par Auto Scaling.**
```
Get-ASAdjustmentType
```
**Sortie** :
```
Type
----
ChangeInCapacity
ExactCapacity
PercentChangeInCapacity
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAdjustmentTypes](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`Get-ASAutoScalingGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les noms de vos groupes Auto Scaling.**
```
Get-ASAutoScalingGroup | format-table -property AutoScalingGroupName
```
**Sortie** :
```
AutoScalingGroupName
--------------------
my-asg-1
my-asg-2
my-asg-3
my-asg-4
my-asg-5
my-asg-6
```
**Exemple 2 : cet exemple décrit le groupe Auto Scaling spécifié.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1
```
**Sortie** :
```
AutoScalingGroupARN : arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480
f03:autoScalingGroupName/my-asg-1
AutoScalingGroupName : my-asg-1
AvailabilityZones : {us-west-2b, us-west-2a}
CreatedTime : 3/1/2015 9:05:31 AM
DefaultCooldown : 300
DesiredCapacity : 2
EnabledMetrics : {}
HealthCheckGracePeriod : 300
HealthCheckType : EC2
Instances : {my-lc}
LaunchConfigurationName : my-lc
LoadBalancerNames : {}
MaxSize : 0
MinSize : 0
PlacementGroup :
Status :
SuspendedProcesses : {}
Tags : {}
TerminationPolicies : {Default}
VPCZoneIdentifier : subnet-e4f33493,subnet-5264e837
```
**Exemple 3 : cet exemple décrit les deux groupes Auto Scaling spécifiés.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName @("my-asg-1", "my-asg-2")
```
**Exemple 4 : cet exemple décrit les instances Auto Scaling pour le groupe Auto Scaling spécifié.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1).Instances
```
**Exemple 5 : cet exemple décrit tous vos groupes Auto Scaling.**
```
Get-ASAutoScalingGroup
```
**Exemple 6 : Cet LaunchTemplate exemple décrit le groupe Auto Scaling spécifié. Cet exemple suppose que les « Options d’achat d’instance » sont définies sur « Adhérer au modèle de lancement ». Si cette option est définie sur « Combiner les options d'achat et les types d'instances », elle est LaunchTemplate accessible à l'aide de « »MixedInstancesPolicy. LaunchTemplate« propriété.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-ag-1).LaunchTemplate
```
**Sortie** :
```
LaunchTemplateId LaunchTemplateName Version
---------------- ------------------ -------
lt-06095fd619cb40371 test-launch-template $Default
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutoScalingGroups](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASAutoScalingInstance`
L'exemple de code suivant montre comment utiliser`Get-ASAutoScalingInstance`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple répertorie vos instances Auto Scaling. IDs **
```
Get-ASAutoScalingInstance | format-table -property InstanceId
```
**Sortie** :
```
InstanceId
----------
i-12345678
i-87654321
i-abcd1234
```
**Exemple 2 : cet exemple décrit l’instance Auto Scaling spécifiée.**
```
Get-ASAutoScalingInstance -InstanceId i-12345678
```
**Sortie** :
```
AutoScalingGroupName : my-asg
AvailabilityZone : us-west-2b
HealthStatus : HEALTHY
InstanceId : i-12345678
LaunchConfigurationName : my-lc
LifecycleState : InService
```
**Exemple 3 : cet exemple décrit les deux instances Auto Scaling spécifiées.**
```
Get-ASAutoScalingInstance -InstanceId @("i-12345678", "i-87654321")
```
**Exemple 4 : cet exemple décrit les instances Auto Scaling pour le groupe Auto Scaling spécifié.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg).Instances | Get-ASAutoScalingInstance
```
**Exemple 5 : cet exemple décrit toutes vos instances Auto Scaling.**
```
Get-ASAutoScalingInstance
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutoScalingInstances](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASAutoScalingNotificationType`
L'exemple de code suivant montre comment utiliser`Get-ASAutoScalingNotificationType`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les types de notification qui sont pris en charge par Auto Scaling.**
```
Get-ASAutoScalingNotificationType
```
**Sortie** :
```
autoscaling:EC2_INSTANCE_LAUNCH
autoscaling:EC2_INSTANCE_LAUNCH_ERROR
autoscaling:EC2_INSTANCE_TERMINATE
autoscaling:EC2_INSTANCE_TERMINATE_ERROR
autoscaling:TEST_NOTIFICATION
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutoScalingNotificationTypes](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASLaunchConfiguration`
L'exemple de code suivant montre comment utiliser`Get-ASLaunchConfiguration`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les noms de vos configurations de lancement.**
```
Get-ASLaunchConfiguration | format-table -property LaunchConfigurationName
```
**Sortie** :
```
LaunchConfigurationName
-----------------------
my-lc-1
my-lc-2
my-lc-3
my-lc-4
my-lc-5
```
**Exemple 2 : cet exemple décrit la configuration de lancement spécifiée.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName my-lc-1
```
**Sortie** :
```
AssociatePublicIpAddress : True
BlockDeviceMappings : {/dev/xvda}
ClassicLinkVPCId :
ClassicLinkVPCSecurityGroups : {}
CreatedTime : 12/12/2014 3:22:08 PM
EbsOptimized : False
IamInstanceProfile :
ImageId : ami-043a5034
InstanceMonitoring : Amazon.AutoScaling.Model.InstanceMonitoring
InstanceType : t2.micro
KernelId :
KeyName :
LaunchConfigurationARN : arn:aws:autoscaling:us-west-2:123456789012:launchConfiguration:7e5f31e4-693b-4604-9322-
e6f68d7fafad:launchConfigurationName/my-lc-1
LaunchConfigurationName : my-lc-1
PlacementTenancy :
RamdiskId :
SecurityGroups : {sg-67ef0308}
SpotPrice :
UserData :
```
**Exemple 3 : cet exemple décrit les deux configurations de lancement spécifiées.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName @("my-lc-1", "my-lc-2")
```
**Exemple 4 : cet exemple décrit toutes vos configurations de lancement.**
```
Get-ASLaunchConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLaunchConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASLifecycleHook`
L'exemple de code suivant montre comment utiliser`Get-ASLifecycleHook`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit le hook de cycle de vie spécifié.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Sortie** :
```
AutoScalingGroupName : my-asg
DefaultResult : ABANDON
GlobalTimeout : 172800
HeartbeatTimeout : 3600
LifecycleHookName : myLifecycleHook
LifecycleTransition : auto-scaling:EC2_INSTANCE_LAUNCHING
NotificationMetadata :
NotificationTargetARN : arn:aws:sns:us-west-2:123456789012:my-topic
RoleARN : arn:aws:iam::123456789012:role/my-iam-role
```
**Exemple 2 : cet exemple décrit tous les hooks de cycle de vie pour le groupe Auto Scaling spécifié.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg
```
**Exemple 3 : cet exemple décrit tous les hooks du cycle de vie pour tous vos groupes Auto Scaling.**
```
Get-ASLifecycleHook
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLifecycleHooks](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASLifecycleHookType`
L'exemple de code suivant montre comment utiliser`Get-ASLifecycleHookType`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les types de hooks de cycle de vie pris en charge par Auto Scaling.**
```
Get-ASLifecycleHookType
```
**Sortie** :
```
autoscaling:EC2_INSTANCE_LAUNCHING
auto-scaling:EC2_INSTANCE_TERMINATING
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLifecycleHookTypes](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASLoadBalancer`
L'exemple de code suivant montre comment utiliser`Get-ASLoadBalancer`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit les équilibreurs de charge pour le groupe Auto Scaling spécifié.**
```
Get-ASLoadBalancer -AutoScalingGroupName my-asg
```
**Sortie** :
```
LoadBalancerName State
---------------- -----
my-lb Added
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASMetricCollectionType`
L'exemple de code suivant montre comment utiliser`Get-ASMetricCollectionType`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les types de collecte de métriques pris en charge par Auto Scaling.**
```
(Get-ASMetricCollectionType).Metrics
```
**Sortie** :
```
Metric
------
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupTerminatingInstances
GroupStandbyInstances
GroupTotalInstances
```
**Exemple 2 : cet exemple répertorie les granularités correspondantes.**
```
(Get-ASMetricCollectionType).Granularities
```
**Sortie** :
```
Granularity
-----------
1Minute
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMetricCollectionTypes](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASNotificationConfiguration`
L'exemple de code suivant montre comment utiliser`Get-ASNotificationConfiguration`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit les actions de notification associées au groupe Auto Scaling spécifié.**
```
Get-ASNotificationConfiguration -AutoScalingGroupName my-asg | format-list
```
**Sortie** :
```
AutoScalingGroupName : my-asg
NotificationType : auto-scaling:EC2_INSTANCE_LAUNCH
TopicARN : arn:aws:sns:us-west-2:123456789012:my-topic
AutoScalingGroupName : my-asg
NotificationType : auto-scaling:EC2_INSTANCE_TERMINATE
TopicARN : arn:aws:sns:us-west-2:123456789012:my-topic
```
**Exemple 2 : cet exemple décrit les actions de notification associées à tous vos groupes Auto Scaling.**
```
Get-ASNotificationConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeNotificationConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASPolicy`
L'exemple de code suivant montre comment utiliser`Get-ASPolicy`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit toutes les stratégies pour le groupe Auto Scaling spécifié.**
```
Get-ASPolicy -AutoScalingGroupName my-asg
```
**Sortie** :
```
AdjustmentType : ChangeInCapacity
Alarms : {}
AutoScalingGroupName : my-asg
Cooldown : 0
EstimatedInstanceWarmup : 0
MetricAggregationType :
MinAdjustmentMagnitude : 0
MinAdjustmentStep : 0
PolicyARN : arn:aws:auto-scaling:us-west-2:123456789012:scalingPolicy:aa3836ab-5462-42c7-adab-e1d769fc24ef
:autoScalingGroupName/my-asg:policyName/myScaleInPolicy
PolicyName : myScaleInPolicy
PolicyType : SimpleScaling
ScalingAdjustment : -1
StepAdjustments : {}
```
**Exemple 2 : cet exemple décrit les stratégies spécifiées pour le groupe Auto Scaling spécifié.**
```
Get-ASPolicy -AutoScalingGroupName my-asg -PolicyName @("myScaleOutPolicy", "myScaleInPolicy")
```
**Exemple 3 : cet exemple décrit toutes les politiques pour tous vos groupes Auto Scaling.**
```
Get-ASPolicy
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePolicies](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASScalingActivity`
L'exemple de code suivant montre comment utiliser`Get-ASScalingActivity`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit les activités de mise à l’échelle des six dernières semaines pour le groupe Auto Scaling spécifié.**
```
Get-ASScalingActivity -AutoScalingGroupName my-asg
```
**Sortie** :
```
ActivityId : 063308ae-aa22-4a9b-94f4-9fae4EXAMPLE
AutoScalingGroupName : my-asg
Cause : At 2015-11-22T15:45:16Z a user request explicitly set group desired capacity changing the desired
capacity from 1 to 2. At 2015-11-22T15:45:34Z an instance was started in response to a difference
between desired and actual capacity, increasing the capacity from 1 to 2.
Description : Launching a new EC2 instance: i-26e715fc
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime : 11/22/2015 7:46:09 AM
Progress : 100
StartTime : 11/22/2015 7:45:35 AM
StatusCode : Successful
StatusMessage :
ActivityId : ce719997-086d-4c73-a2f1-ab703EXAMPLE
AutoScalingGroupName : my-asg
Cause : At 2015-11-20T22:57:53Z a user request created an AutoScalingGroup changing the desired capacity
from 0 to 1. At 2015-11-20T22:57:58Z an instance was started in response to a difference betwe
en desired and actual capacity, increasing the capacity from 0 to 1.
Description : Launching a new EC2 instance: i-93633f9b
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime : 11/20/2015 2:58:32 PM
Progress : 100
StartTime : 11/20/2015 2:57:59 PM
StatusCode : Successful
StatusMessage :
```
**Exemple 2 : cet exemple décrit l’activité de mise à l’échelle spécifiée.**
```
Get-ASScalingActivity -ActivityId "063308ae-aa22-4a9b-94f4-9fae4EXAMPLE"
```
**Exemple 3 : cet exemple décrit les activités de mise à l’échelle des six dernières semaines pour tous vos groupes Auto Scaling.**
```
Get-ASScalingActivity
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScalingActivities](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASScalingProcessType`
L'exemple de code suivant montre comment utiliser`Get-ASScalingProcessType`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les types de processus pris en charge par Auto Scaling.**
```
Get-ASScalingProcessType
```
**Sortie** :
```
ProcessName
-----------
AZRebalance
AddToLoadBalancer
AlarmNotification
HealthCheck
Launch
ReplaceUnhealthy
ScheduledActions
Terminate
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScalingProcessTypes](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASScheduledAction`
L'exemple de code suivant montre comment utiliser`Get-ASScheduledAction`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit les actions de mise à l’échelle planifiées pour le groupe Auto Scaling spécifié.**
```
Get-ASScheduledAction -AutoScalingGroupName my-asg
```
**Sortie** :
```
AutoScalingGroupName : my-asg
DesiredCapacity : 10
EndTime :
MaxSize :
MinSize :
Recurrence :
ScheduledActionARN : arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8a4c5f24-6ec6-4306-a2dd-f7
2c3af3a4d6:autoScalingGroupName/my-asg:scheduledActionName/myScheduledAction
ScheduledActionName : myScheduledAction
StartTime : 11/30/2015 8:00:00 AM
Time : 11/30/2015 8:00:00 AM
```
**Exemple 2 : cet exemple décrit les actions de mise à l’échelle planifiées spécifiées.**
```
Get-ASScheduledAction -ScheduledActionName @("myScheduledScaleOut", "myScheduledScaleIn")
```
**Exemple 3 : cet exemple décrit les actions de mise à l’échelle planifiées qui commencent à l’heure spécifiée.**
```
Get-ASScheduledAction -StartTime "2015-12-01T08:00:00Z"
```
**Exemple 4 : cet exemple décrit les actions de mise à l’échelle planifiées qui se terminent à l’heure spécifiée.**
```
Get-ASScheduledAction -EndTime "2015-12-30T08:00:00Z"
```
**Exemple 5 : cet exemple décrit les actions de mise à l’échelle planifiées pour tous vos groupes Auto Scaling.**
```
Get-ASScheduledAction
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScheduledActions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASTag`
L'exemple de code suivant montre comment utiliser`Get-ASTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit les balises dont la valeur clé est « myTag » ou « myTag2 ». Les valeurs possibles pour le nom du filtre sont auto-scaling-group « », « key », « value » et « propagate-at-launch ». La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )
```
**Sortie** :
```
Key : myTag2
PropagateAtLaunch : True
ResourceId : my-asg
ResourceType : auto-scaling-group
Value : myTagValue2
Key : myTag
PropagateAtLaunch : True
ResourceId : my-asg
ResourceType : auto-scaling-group
Value : myTagValue
```
**Exemple 2 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer le filtre pour le paramètre Filter.**
```
$keys = New-Object string[] 2
$keys[0] = "myTag"
$keys[1] = "myTag2"
$filter = New-Object Amazon.AutoScaling.Model.Filter
$filter.Name = "key"
$filter.Values = $keys
Get-ASTag -Filter @( $filter )
```
**Exemple 3 : cet exemple décrit toutes les balises pour tous vos groupes Auto Scaling.**
```
Get-ASTag
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ASTerminationPolicyType`
L'exemple de code suivant montre comment utiliser`Get-ASTerminationPolicyType`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les politiques de résiliation prises en charge par Auto Scaling.**
```
Get-ASTerminationPolicyType
```
**Sortie** :
```
ClosestToNextInstanceHour
Default
NewestInstance
OldestInstance
OldestLaunchConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTerminationPolicyTypes](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Mount-ASInstance`
L'exemple de code suivant montre comment utiliser`Mount-ASInstance`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple attache l’instance spécifiée au groupe Auto Scaling spécifié. Auto Scaling augmente automatiquement la capacité souhaitée du groupe Auto Scaling.**
```
Mount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [AttachInstances](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-ASAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`New-ASAutoScalingGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée un groupe Auto Scaling avec le nom et les attributs spécifiés. La capacité souhaitée par défaut est la taille minimale. Par conséquent, ce groupe Auto Scaling lance deux instances, une dans chacune des deux zones de disponibilité spécifiées.**
```
New-ASAutoScalingGroup -AutoScalingGroupName my-asg -LaunchConfigurationName my-lc -MinSize 2 -MaxSize 6 -AvailabilityZone @("us-west-2a", "us-west-2b")
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-ASLaunchConfiguration`
L'exemple de code suivant montre comment utiliser`New-ASLaunchConfiguration`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée une configuration de lancement nommée « my-lc ». Les EC2 instances lancées par les groupes Auto Scaling qui utilisent cette configuration de lancement utilisent le type d'instance, l'AMI, le groupe de sécurité et le rôle IAM spécifiés.**
```
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-ASAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`Remove-ASAutoScalingGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime le groupe Auto Scaling spécifié s’il ne possède aucune instance en cours d’exécution. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASAutoScalingGroup (DeleteAutoScalingGroup)" on Target "my-asg".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -Force
```
**Exemple 3 : cet exemple supprime le groupe Auto Scaling spécifié et résilie toutes les instances en cours d’exécution qu’il contient.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -ForceDelete $true -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-ASLaunchConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-ASLaunchConfiguration`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime la configuration de lancement spécifiée si elle n’est pas attachée à un groupe Auto Scaling. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASLaunchConfiguration (DeleteLaunchConfiguration)" on Target "my-lc".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-ASLifecycleHook`
L'exemple de code suivant montre comment utiliser`Remove-ASLifecycleHook`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime le hook de cycle de vie spécifié pour le groupe Auto Scaling spécifié. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASLifecycleHook (DeleteLifecycleHook)" on Target "myLifecycleHook".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-ASNotificationConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-ASNotificationConfiguration`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime l’action de notification spécifiée. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASNotificationConfiguration (DeleteNotificationConfiguration)" on Target
"arn:aws:sns:us-west-2:123456789012:my-topic".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteNotificationConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-ASPolicy`
L'exemple de code suivant montre comment utiliser`Remove-ASPolicy`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime la politique spécifiée pour le groupe Auto Scaling spécifié. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASPolicy (DeletePolicy)" on Target "myScaleInPolicy".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePolicy](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-ASScheduledAction`
L'exemple de code suivant montre comment utiliser`Remove-ASScheduledAction`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime l’action planifiée spécifiée pour le groupe Auto Scaling spécifié. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASScheduledAction (DeleteScheduledAction)" on Target "myScheduledAction".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction" -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteScheduledAction](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-ASTag`
L'exemple de code suivant montre comment utiliser`Remove-ASTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime la balise spécifiée du groupe Auto Scaling spécifié. Vous êtes invité à confirmer avant que l’opération ne se poursuive. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } )
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ASTag (DeleteTags)" on target "Amazon.AutoScaling.Model.Tag".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } ) -Force
```
**Exemple 3 : avec PowerShell version 2, vous devez utiliser New-Object pour créer la balise pour le paramètre Balise.**
```
$tag = New-Object Amazon.AutoScaling.Model.Tag
$tag.ResourceType = "auto-scaling-group"
$tag.ResourceId = "my-asg"
$tag.Key = "myTag"
Remove-ASTag -Tag $tag -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Resume-ASProcess`
L'exemple de code suivant montre comment utiliser`Resume-ASProcess`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple reprend le processus Auto Scaling spécifié pour le groupe Auto Scaling spécifié.**
```
Resume-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Exemple 2 : cet exemple reprend tous les processus Auto Scaling suspendus pour le groupe Auto Scaling spécifié.**
```
Resume-ASProcess -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [ResumeProcesses](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Set-ASDesiredCapacity`
L'exemple de code suivant montre comment utiliser`Set-ASDesiredCapacity`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple définit la taille du groupe Auto Scaling spécifié.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2
```
**Exemple 2 : cet exemple définit la taille du groupe Auto Scaling spécifié et attend la fin du temps de stabilisation avant de le mettre à la nouvelle taille.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2 -HonorCooldown $true
```
+ Pour plus de détails sur l'API, reportez-vous [SetDesiredCapacity](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Set-ASInstanceHealth`
L'exemple de code suivant montre comment utiliser`Set-ASInstanceHealth`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple définit le statut de l’instance spécifiée sur « Non fonctionnelle », la mettant hors service. Auto Scaling résilie l’instance et la remplace.**
```
Set-ASInstanceHealth -HealthStatus Unhealthy -InstanceId i-93633f9b
```
**Exemple 2 : cet exemple définit le statut de l’instance spécifiée sur « Saine », afin de la maintenir en service. Aucune période de grâce de la surveillance de l’état pour le groupe Auto Scaling n’est respectée.**
```
Set-ASInstanceHealth -HealthStatus Healthy -InstanceId i-93633f9b -ShouldRespectGracePeriod $false
```
+ Pour plus de détails sur l'API, reportez-vous [SetInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Set-ASInstanceProtection`
L'exemple de code suivant montre comment utiliser`Set-ASInstanceProtection`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple active la protection de l’instance pour l’instance spécifiée.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $true
```
**Exemple 2 : cet exemple désactive la protection d’instance pour l’instance spécifiée.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $false
```
+ Pour plus de détails sur l'API, reportez-vous [SetInstanceProtection](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Set-ASTag`
L'exemple de code suivant montre comment utiliser`Set-ASTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple ajoute une balise unique au groupe Auto Scaling spécifié. La clé de balise est « MyTag » et la valeur de la balise est « myTagValue ». Auto Scaling propage cette balise aux EC2 instances suivantes lancées par le groupe Auto Scaling. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Set-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag"; Value="myTagValue"; PropagateAtLaunch=$true} )
```
**Exemple 2 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer la balise pour le paramètre Tag.**
```
$tag = New-Object Amazon.AutoScaling.Model.Tag
$tag.ResourceType = "auto-scaling-group"
$tag.ResourceId = "my-asg"
$tag.Key = "myTag"
$tag.Value = "myTagValue"
$tag.PropagateAtLaunch = $true
Set-ASTag -Tag $tag
```
+ Pour plus de détails sur l'API, reportez-vous [CreateOrUpdateTags](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Start-ASPolicy`
L'exemple de code suivant montre comment utiliser`Start-ASPolicy`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple exécute la politique spécifiée pour le groupe Auto Scaling spécifié.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy"
```
**Exemple 2 : cet exemple exécute la politique spécifiée pour le groupe Auto Scaling spécifié, après avoir attendu la fin du temps de stabilisation.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy" -HonorCooldown $true
```
+ Pour plus de détails sur l'API, reportez-vous [ExecutePolicy](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Stop-ASInstanceInAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`Stop-ASInstanceInAutoScalingGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple résilie l’instance spécifiée et réduit la capacité souhaitée de son groupe Auto Scaling afin qu’Auto Scaling ne lance pas d’instance de remplacement.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $true
```
**Sortie** :
```
ActivityId : 2e40d9bd-1902-444c-abf3-6ea0002efdc5
AutoScalingGroupName :
Cause : At 2015-11-22T16:09:03Z instance i-93633f9b was taken out of service in response to a user
request, shrinking the capacity from 2 to 1.
Description : Terminating EC2 instance: i-93633f9b
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 0
StartTime : 11/22/2015 8:09:03 AM
StatusCode : InProgress
StatusMessage :
```
**Exemple 2 : cet exemple résilie l’instance spécifiée sans réduire la capacité souhaitée de son groupe Auto Scaling. Auto Scaling lance une instance de remplacement.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $false
```
**Sortie** :
```
ActivityId : 2e40d9bd-1902-444c-abf3-6ea0002efdc5
AutoScalingGroupName :
Cause : At 2015-11-22T16:09:03Z instance i-93633f9b was taken out of service in response to a user
request.
Description : Terminating EC2 instance: i-93633f9b
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 0
StartTime : 11/22/2015 8:09:03 AM
StatusCode : InProgress
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [TerminateInstanceInAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Suspend-ASProcess`
L'exemple de code suivant montre comment utiliser`Suspend-ASProcess`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple suspend le processus Auto Scaling spécifié pour le groupe Auto Scaling spécifié.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Exemple 2 : cet exemple suspend tous les processus Auto Scaling pour le groupe Auto Scaling spécifié.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [SuspendProcesses](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-ASAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`Update-ASAutoScalingGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met à jour la taille minimale et maximale du groupe Auto Scaling spécifié.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**Exemple 2 : cet exemple met à jour le temps de stabilisation par défaut du groupe Auto Scaling spécifié.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**Exemple 3 : cet exemple met à jour les zones de disponibilité du groupe Auto Scaling spécifié.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**Exemple 4 : cet exemple met à jour le groupe Auto Scaling spécifié pour utiliser les surveillances de l’état Elastic Load Balancing.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-ASLifecycleActionHeartbeat`
L'exemple de code suivant montre comment utiliser`Write-ASLifecycleActionHeartbeat`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple enregistre une pulsation pour l’action du cycle de vie spécifiée. Cela permet de maintenir l’instance en attente jusqu’à ce que vous ayez terminé l’action personnalisée.**
```
Write-ASLifecycleActionHeartbeat -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Pour plus de détails sur l'API, reportez-vous [RecordLifecycleActionHeartbeat](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-ASLifecycleHook`
L'exemple de code suivant montre comment utiliser`Write-ASLifecycleHook`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple ajoute le hook de cycle de vie spécifié au groupe Auto Scaling spécifié.**
```
Write-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName "myLifecycleHook" -LifecycleTransition "autoscaling:EC2_INSTANCE_LAUNCHING" -NotificationTargetARN "arn:aws:sns:us-west-2:123456789012:my-sns-topic" -RoleARN "arn:aws:iam::123456789012:role/my-iam-role"
```
+ Pour plus de détails sur l'API, reportez-vous [PutLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-ASNotificationConfiguration`
L'exemple de code suivant montre comment utiliser`Write-ASNotificationConfiguration`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple configure le groupe Auto Scaling spécifié pour envoyer une notification à la rubrique SNS spécifiée lorsqu'il lance EC2 des instances.**
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType "autoscaling:EC2_INSTANCE_LAUNCH" -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Exemple 2 : Cet exemple configure le groupe Auto Scaling spécifié pour envoyer une notification à la rubrique SNS spécifiée lorsqu'il lance ou met fin EC2 à des instances.**
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType @("autoscaling:EC2_INSTANCE_LAUNCH", "autoscaling:EC2_INSTANCE_TERMINATE") -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
+ Pour plus de détails sur l'API, reportez-vous [PutNotificationConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-ASScalingPolicy`
L'exemple de code suivant montre comment utiliser`Write-ASScalingPolicy`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple ajoute la politique spécifiée au groupe Auto Scaling spécifié. Le type de réglage spécifié détermine la manière d'interpréter le ScalingAdjustment paramètre. Avec « ChangeInCapacity », une valeur positive augmente la capacité du nombre d'instances spécifié et une valeur négative diminue la capacité du nombre d'instances spécifié.**
```
Write-ASScalingPolicy -AutoScalingGroupName my-asg -AdjustmentType "ChangeInCapacity" -PolicyName "myScaleInPolicy" -ScalingAdjustment -1
```
**Sortie** :
```
arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:aa3836ab-5462-42c7-adab-e1d769fc24ef:autoScalingGroupName/my-asg
:policyName/myScaleInPolicy
```
+ Pour plus de détails sur l'API, reportez-vous [PutScalingPolicy](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-ASScheduledUpdateGroupAction`
L'exemple de code suivant montre comment utiliser`Write-ASScheduledUpdateGroupAction`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée ou met à jour une action planifiée unique pour modifier la capacité souhaitée à l’heure de début spécifiée.**
```
Write-ASScheduledUpdateGroupAction -AutoScalingGroupName my-asg -ScheduledActionName "myScheduledAction" -StartTime "2015-12-01T00:00:00Z" -DesiredCapacity 10
```
+ Pour plus de détails sur l'API, reportez-vous [PutScheduledUpdateGroupAction](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.