Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos de Auto Scaling usando o Tools for V5 PowerShell
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V5 com Auto Scaling.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `Add-ASLoadBalancer`
O código de exemplo a seguir mostra como usar `Add-ASLoadBalancer`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo anexa o Balanceador de Carga especificado ao grupo do Auto Scaling especificado.**
```
Add-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Para obter detalhes da API, consulte [AttachLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Complete-ASLifecycleAction`
O código de exemplo a seguir mostra como usar `Complete-ASLifecycleAction`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo conclui a ação de ciclo de vida especificada.**
```
Complete-ASLifecycleAction -LifecycleHookName myLifecycleHook -AutoScalingGroupName my-asg -LifecycleActionResult CONTINUE -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Para obter detalhes da API, consulte [CompleteLifecycleAction](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Disable-ASMetricsCollection`
O código de exemplo a seguir mostra como usar `Disable-ASMetricsCollection`.
**Ferramentas para PowerShell V5**
**Example 1: Desativa o monitoramento de métricas especificadas para o grupo de Auto Scaling.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg -Metric @("GroupMinSize", "GroupMaxSize")
```
**Exemplo 2: Esse exemplo desativa o monitoramento de todas as métricas do grupo do Auto Scaling especificado.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg
```
+ Para obter detalhes da API, consulte [DisableMetricsCollection](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Dismount-ASInstance`
O código de exemplo a seguir mostra como usar `Dismount-ASInstance`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo desvincula a instância especificada do grupo do Auto Scaling especificado e diminui a capacidade desejada para que o Auto Scaling não inicie uma instância substituta.**
```
Dismount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Saída**:
```
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 :
```
**Exemplo 2: Este exemplo desvincula a instância especificada do grupo de Auto Scaling especificado sem diminuir a capacidade desejada. O Auto Scaling inicia uma nova instância de substituição.**
```
Dismount-ASInstance -InstanceId i-7bf746a2 -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Saída**:
```
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 :
```
+ Para obter detalhes da API, consulte [DetachInstances](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Dismount-ASLoadBalancer`
O código de exemplo a seguir mostra como usar `Dismount-ASLoadBalancer`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo desvincula o balanceador de carga especificado do grupo de Auto Scaling especificado.**
```
Dismount-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Para obter detalhes da API, consulte [DetachLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Enable-ASMetricsCollection`
O código de exemplo a seguir mostra como usar `Enable-ASMetricsCollection`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Ativa o monitoramento de métricas especificadas para o grupo de Auto Scaling.**
```
Enable-ASMetricsCollection -Metric @("GroupMinSize", "GroupMaxSize") -AutoScalingGroupName my-asg -Granularity 1Minute
```
**Exemplo 2: Este exemplo permite o monitoramento de todas as métricas do grupo do Auto Scaling especificado.**
```
Enable-ASMetricsCollection -AutoScalingGroupName my-asg -Granularity 1Minute
```
+ Para obter detalhes da API, consulte [EnableMetricsCollection](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Enter-ASStandby`
O código de exemplo a seguir mostra como usar `Enter-ASStandby`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo coloca a instância especificada em modo de espera e diminui a capacidade desejada para que o Auto Scaling não inicie uma instância substituta.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Saída**:
```
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 :
```
**Exemplo 2: Este exemplo coloca a instância especificada em modo de espera sem diminuir a capacidade desejada. O Auto Scaling inicia uma nova instância de substituição.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Saída**:
```
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 :
```
+ Para obter detalhes da API, consulte [EnterStandby](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Exit-ASStandby`
O código de exemplo a seguir mostra como usar `Exit-ASStandby`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo tira as instâncias especificadas do modo de espera.**
```
Exit-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
**Saída**:
```
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 :
```
+ Para obter detalhes da API, consulte [ExitStandby](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASAccountLimit`
O código de exemplo a seguir mostra como usar `Get-ASAccountLimit`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo descreve os limites de recursos do Auto Scaling para sua AWS conta.**
```
Get-ASAccountLimit
```
**Saída**:
```
MaxNumberOfAutoScalingGroups : 20
MaxNumberOfLaunchConfigurations : 100
```
+ Para obter detalhes da API, consulte [DescribeAccountLimits](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASAdjustmentType`
O código de exemplo a seguir mostra como usar `Get-ASAdjustmentType`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo descreve os tipos de ajuste que são compatíveis com o Auto Scaling.**
```
Get-ASAdjustmentType
```
**Saída**:
```
Type
----
ChangeInCapacity
ExactCapacity
PercentChangeInCapacity
```
+ Para obter detalhes da API, consulte [DescribeAdjustmentTypes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASAutoScalingGroup`
O código de exemplo a seguir mostra como usar `Get-ASAutoScalingGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo lista os nomes de seus grupos do Auto Scaling.**
```
Get-ASAutoScalingGroup | format-table -property AutoScalingGroupName
```
**Saída**:
```
AutoScalingGroupName
--------------------
my-asg-1
my-asg-2
my-asg-3
my-asg-4
my-asg-5
my-asg-6
```
**Exemplo 2: Este exemplo descreve o grupo do Auto Scaling especificado.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1
```
**Saída**:
```
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
```
**Exemplo 3: Este exemplo descreve os grupos do Auto Scaling especificados.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName @("my-asg-1", "my-asg-2")
```
**Exemplo 4: Este exemplo descreve as instâncias do Auto Scaling do grupo do Auto Scaling especificado.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1).Instances
```
**Exemplo 5: Este exemplo descreve todos os seus grupos do Auto Scaling.**
```
Get-ASAutoScalingGroup
```
**Exemplo 6: Este LaunchTemplate exemplo descreve o grupo de Auto Scaling especificado. Este exemplo pressupõe que as “Opções de compra de instância” estejam definidas como “Aderir ao modelo de lançamento”. Caso essa opção esteja definida como “Combinar opções de compra e tipos de instância”, LaunchTemplate pode ser acessada usando "MixedInstancesPolicy. LaunchTemplate” propriedade.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-ag-1).LaunchTemplate
```
**Saída**:
```
LaunchTemplateId LaunchTemplateName Version
---------------- ------------------ -------
lt-06095fd619cb40371 test-launch-template $Default
```
+ Para obter detalhes da API, consulte [DescribeAutoScalingGroups](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASAutoScalingInstance`
O código de exemplo a seguir mostra como usar `Get-ASAutoScalingInstance`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo lista as suas IDs instâncias do Auto Scaling.**
```
Get-ASAutoScalingInstance | format-table -property InstanceId
```
**Saída**:
```
InstanceId
----------
i-12345678
i-87654321
i-abcd1234
```
**Exemplo 2: Este exemplo descreve a instância do Auto Scaling especificada.**
```
Get-ASAutoScalingInstance -InstanceId i-12345678
```
**Saída**:
```
AutoScalingGroupName : my-asg
AvailabilityZone : us-west-2b
HealthStatus : HEALTHY
InstanceId : i-12345678
LaunchConfigurationName : my-lc
LifecycleState : InService
```
**Exemplo 3: Este exemplo descreve duas instâncias do Auto Scaling especificadas.**
```
Get-ASAutoScalingInstance -InstanceId @("i-12345678", "i-87654321")
```
**Exemplo 4: Este exemplo descreve as instâncias do Auto Scaling do grupo do Auto Scaling especificado.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg).Instances | Get-ASAutoScalingInstance
```
**Exemplo 5: Este exemplo descreve todas as instâncias do Auto Scaling.**
```
Get-ASAutoScalingInstance
```
+ Para obter detalhes da API, consulte [DescribeAutoScalingInstances](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASAutoScalingNotificationType`
O código de exemplo a seguir mostra como usar `Get-ASAutoScalingNotificationType`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo lista os tipos de notificação compatíveis com o Auto Scaling.**
```
Get-ASAutoScalingNotificationType
```
**Saída**:
```
autoscaling:EC2_INSTANCE_LAUNCH
autoscaling:EC2_INSTANCE_LAUNCH_ERROR
autoscaling:EC2_INSTANCE_TERMINATE
autoscaling:EC2_INSTANCE_TERMINATE_ERROR
autoscaling:TEST_NOTIFICATION
```
+ Para obter detalhes da API, consulte [DescribeAutoScalingNotificationTypes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASLaunchConfiguration`
O código de exemplo a seguir mostra como usar `Get-ASLaunchConfiguration`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo lista os nomes de suas configurações de execução.**
```
Get-ASLaunchConfiguration | format-table -property LaunchConfigurationName
```
**Saída**:
```
LaunchConfigurationName
-----------------------
my-lc-1
my-lc-2
my-lc-3
my-lc-4
my-lc-5
```
**Exemplo 2: Este exemplo descreve a configuração de execução especificada.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName my-lc-1
```
**Saída**:
```
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 :
```
**Exemplo 3: Este exemplo descreve as duas configurações de execução especificadas.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName @("my-lc-1", "my-lc-2")
```
**Exemplo 4: Este exemplo descreve todas as suas configurações de execução.**
```
Get-ASLaunchConfiguration
```
+ Para obter detalhes da API, consulte [DescribeLaunchConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASLifecycleHook`
O código de exemplo a seguir mostra como usar `Get-ASLifecycleHook`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo descreve o gancho do ciclo de vida especificado.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Saída**:
```
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
```
**Exemplo 2: Descreve os ganchos do ciclo de vida do grupo de Auto Scaling especificado.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg
```
**Exemplo 3: Este exemplo descreve todos ganchos do ciclo de vida os todos seus grupos do Auto Scaling.**
```
Get-ASLifecycleHook
```
+ Para obter detalhes da API, consulte [DescribeLifecycleHooks](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASLifecycleHookType`
O código de exemplo a seguir mostra como usar `Get-ASLifecycleHookType`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo lista os tipos de gancho do ciclo de vida compatíveis com o Auto Scaling.**
```
Get-ASLifecycleHookType
```
**Saída**:
```
autoscaling:EC2_INSTANCE_LAUNCHING
auto-scaling:EC2_INSTANCE_TERMINATING
```
+ Para obter detalhes da API, consulte [DescribeLifecycleHookTypes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASLoadBalancer`
O código de exemplo a seguir mostra como usar `Get-ASLoadBalancer`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Descreve os load balancers do grupo de Auto Scaling especificado.**
```
Get-ASLoadBalancer -AutoScalingGroupName my-asg
```
**Saída**:
```
LoadBalancerName State
---------------- -----
my-lb Added
```
+ Para obter detalhes da API, consulte [DescribeLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASMetricCollectionType`
O código de exemplo a seguir mostra como usar `Get-ASMetricCollectionType`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo lista os tipos de coleta de métricas compatíveis com o Auto Scaling.**
```
(Get-ASMetricCollectionType).Metrics
```
**Saída**:
```
Metric
------
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupTerminatingInstances
GroupStandbyInstances
GroupTotalInstances
```
**Exemplo 2: Este exemplo lista as granularidades correspondentes.**
```
(Get-ASMetricCollectionType).Granularities
```
**Saída**:
```
Granularity
-----------
1Minute
```
+ Para obter detalhes da API, consulte [DescribeMetricCollectionTypes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASNotificationConfiguration`
O código de exemplo a seguir mostra como usar `Get-ASNotificationConfiguration`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Esse exemplo descreve as ações de notificação associadas ao grupo de Auto Scaling especificado.**
```
Get-ASNotificationConfiguration -AutoScalingGroupName my-asg | format-list
```
**Saída**:
```
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
```
**Exemplo 2: Este exemplo descreve as ações de notificação associadas a todos os seus grupos do Auto Scaling.**
```
Get-ASNotificationConfiguration
```
+ Para obter detalhes da API, consulte [DescribeNotificationConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASPolicy`
O código de exemplo a seguir mostra como usar `Get-ASPolicy`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Esse exemplo descreve o grupo do Auto Scaling especificado.**
```
Get-ASPolicy -AutoScalingGroupName my-asg
```
**Saída**:
```
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 : {}
```
**Exemplo 2: Este exemplo descreve duas políticas especificadas para o grupo do Auto Scaling especificado.**
```
Get-ASPolicy -AutoScalingGroupName my-asg -PolicyName @("myScaleOutPolicy", "myScaleInPolicy")
```
**Exemplo 3: Este exemplo descreve todas as políticas para todos os seus grupos do Auto Scaling.**
```
Get-ASPolicy
```
+ Para obter detalhes da API, consulte [DescribePolicies](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASScalingActivity`
O código de exemplo a seguir mostra como usar `Get-ASScalingActivity`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo descreve as ações de escalabilidade das últimas seis semanas do grupo do Auto Scaling especificado.**
```
Get-ASScalingActivity -AutoScalingGroupName my-asg
```
**Saída**:
```
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 :
```
**Exemplo 2: Este exemplo descreve a atividade de escala especificada.**
```
Get-ASScalingActivity -ActivityId "063308ae-aa22-4a9b-94f4-9fae4EXAMPLE"
```
**Exemplo 3: Este exemplo descreve as atividades de escala das últimas seis semanas para todos os seus grupos do Auto Scaling.**
```
Get-ASScalingActivity
```
+ Para obter detalhes da API, consulte [DescribeScalingActivities](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASScalingProcessType`
O código de exemplo a seguir mostra como usar `Get-ASScalingProcessType`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo lista os tipos de processo compatíveis com o Auto Scaling.**
```
Get-ASScalingProcessType
```
**Saída**:
```
ProcessName
-----------
AZRebalance
AddToLoadBalancer
AlarmNotification
HealthCheck
Launch
ReplaceUnhealthy
ScheduledActions
Terminate
```
+ Para obter detalhes da API, consulte [DescribeScalingProcessTypes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASScheduledAction`
O código de exemplo a seguir mostra como usar `Get-ASScheduledAction`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo descreve as ações de escalabilidade agendadas do grupo do Auto Scaling especificado.**
```
Get-ASScheduledAction -AutoScalingGroupName my-asg
```
**Saída**:
```
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
```
**Exemplo 2: Este exemplo descreve as ações de escala programada especificadas.**
```
Get-ASScheduledAction -ScheduledActionName @("myScheduledScaleOut", "myScheduledScaleIn")
```
**Exemplo 3: Este exemplo descreve as ações de escala programadas que começam no horário especificado.**
```
Get-ASScheduledAction -StartTime "2015-12-01T08:00:00Z"
```
**Exemplo 4: Este exemplo descreve as ações de escala programadas que terminam no horário especificado.**
```
Get-ASScheduledAction -EndTime "2015-12-30T08:00:00Z"
```
**Exemplo 5: Este exemplo descreve as ações de escala programadas para todos os seus grupos do Auto Scaling.**
```
Get-ASScheduledAction
```
+ Para obter detalhes da API, consulte [DescribeScheduledActions](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASTag`
O código de exemplo a seguir mostra como usar `Get-ASTag`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo descreve as tags com um valor-chave de “myTag” ou “myTag2”. Os valores possíveis para o nome do filtro são auto-scaling-group '', 'chave', 'valor' e 'propagate-at-launch'. A sintaxe usada neste exemplo requer a PowerShell versão 3 ou posterior.**
```
Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )
```
**Saída**:
```
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
```
**Exemplo 2: Com a PowerShell versão 2, você deve usar New-Object para criar o filtro para o parâmetro 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 )
```
**Exemplo 3: Este exemplo descreve todas as tags para tudos seus grupos do Auto Scaling.**
```
Get-ASTag
```
+ Para obter detalhes da API, consulte [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ASTerminationPolicyType`
O código de exemplo a seguir mostra como usar `Get-ASTerminationPolicyType`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo lista as políticas de terminação que são compatíveis com o Auto Scaling.**
```
Get-ASTerminationPolicyType
```
**Saída**:
```
ClosestToNextInstanceHour
Default
NewestInstance
OldestInstance
OldestLaunchConfiguration
```
+ Para obter detalhes da API, consulte [DescribeTerminationPolicyTypes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Mount-ASInstance`
O código de exemplo a seguir mostra como usar `Mount-ASInstance`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo anexa o grupo de destino especificado ao grupo do Auto Scaling especificado. O Auto Scaling aumenta automaticamente a capacidade desejada do grupo do Auto Scaling.**
```
Mount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
+ Para obter detalhes da API, consulte [AttachInstances](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-ASAutoScalingGroup`
O código de exemplo a seguir mostra como usar `New-ASAutoScalingGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo cria um grupo do Auto Scaling com o nome e os atributos especificados. A capacidade desejada padrão é o tamanho mínimo. Portanto, esse grupo do Auto Scaling inicia duas instâncias, uma em cada uma das duas zonas de disponibilidade especificadas.**
```
New-ASAutoScalingGroup -AutoScalingGroupName my-asg -LaunchConfigurationName my-lc -MinSize 2 -MaxSize 6 -AvailabilityZone @("us-west-2a", "us-west-2b")
```
+ Para obter detalhes da API, consulte [CreateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-ASLaunchConfiguration`
O código de exemplo a seguir mostra como usar `New-ASLaunchConfiguration`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo cria uma configuração de inicialização chamada “my-lc”. As instâncias do EC2 iniciadas por grupos do Auto Scaling que usam essa configuração de inicialização usam o tipo de instância, a AMI, o grupo de segurança e o perfil do IAM especificados.**
```
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"
```
+ Para obter detalhes da API, consulte [CreateLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-ASAutoScalingGroup`
O código de exemplo a seguir mostra como usar `Remove-ASAutoScalingGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo exclui o grupo do Auto Scaling especificado se ele não tiver instâncias em execução. A confirmação será solicitada antes que a operação continue.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg
```
**Saída**:
```
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"):
```
**Exemplo 2: Se você especificar o parâmetro Force, não será solicitada a confirmação antes de prosseguir com a operação.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -Force
```
**Exemplo 3: Este exemplo exclui o grupo do Auto Scaling especificado e encerra todas as instâncias em execução que ele contém.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -ForceDelete $true -Force
```
+ Para obter detalhes da API, consulte [DeleteAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-ASLaunchConfiguration`
O código de exemplo a seguir mostra como usar `Remove-ASLaunchConfiguration`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo exclui a configuração de inicialização especificada se ela não estiver anexada a um grupo do Auto Scaling. A confirmação será solicitada antes que a operação continue.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc
```
**Saída**:
```
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"):
```
**Exemplo 2: Se você especificar o parâmetro Force, não será solicitada a confirmação antes de prosseguir com a operação.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc -Force
```
+ Para obter detalhes da API, consulte [DeleteLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-ASLifecycleHook`
O código de exemplo a seguir mostra como usar `Remove-ASLifecycleHook`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo exclui o gancho do ciclo de vida especificado para o grupo do Auto Scaling especificado. A confirmação será solicitada antes que a operação continue.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Saída**:
```
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"):
```
**Exemplo 2: Se você especificar o parâmetro Force, não será solicitada a confirmação antes de prosseguir com a operação.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -Force
```
+ Para obter detalhes da API, consulte [DeleteLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-ASNotificationConfiguration`
O código de exemplo a seguir mostra como usar `Remove-ASNotificationConfiguration`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo exclui a ação de notificação especificada. A confirmação será solicitada antes que a operação continue.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Saída**:
```
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"):
```
**Exemplo 2: Se você especificar o parâmetro Force, não será solicitada a confirmação antes de prosseguir com a operação.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" -Force
```
+ Para obter detalhes da API, consulte [DeleteNotificationConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-ASPolicy`
O código de exemplo a seguir mostra como usar `Remove-ASPolicy`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo exclui a política especificada para o grupo do Auto Scaling especificado. A confirmação será solicitada antes que a operação continue.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy
```
**Saída**:
```
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"):
```
**Exemplo 2: Se você especificar o parâmetro Force, não será solicitada a confirmação antes de prosseguir com a operação.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy -Force
```
+ Para obter detalhes da API, consulte [DeletePolicy](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-ASScheduledAction`
O código de exemplo a seguir mostra como usar `Remove-ASScheduledAction`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo exclui a política especificada para o grupo do Auto Scaling especificado. A confirmação será solicitada antes que a operação continue.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction"
```
**Saída**:
```
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"):
```
**Exemplo 2: Se você especificar o parâmetro Force, não será solicitada a confirmação antes de prosseguir com a operação.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction" -Force
```
+ Para obter detalhes da API, consulte [DeleteScheduledAction](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-ASTag`
O código de exemplo a seguir mostra como usar `Remove-ASTag`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo remove a tag especificada do grupo do Auto Scaling especificado. A confirmação será solicitada antes que a operação continue. A sintaxe usada neste exemplo requer a PowerShell versão 3 ou posterior.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } )
```
**Saída**:
```
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"):
```
**Exemplo 2: Se você especificar o parâmetro Force, não será solicitada a confirmação antes de prosseguir com a operação.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } ) -Force
```
**Exemplo 3: com o PowerShell versão, é necessário usar New-Object para criar a tag para o parâmetro de Tag.**
```
$tag = New-Object Amazon.AutoScaling.Model.Tag
$tag.ResourceType = "auto-scaling-group"
$tag.ResourceId = "my-asg"
$tag.Key = "myTag"
Remove-ASTag -Tag $tag -Force
```
+ Para obter detalhes da API, consulte [DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Resume-ASProcess`
O código de exemplo a seguir mostra como usar `Resume-ASProcess`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Esse exemplo reinicia o processo do Auto Scaling especificado para o grupo de Auto Scaling especificado.**
```
Resume-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Exemplo 2: Este exemplo retoma todos os processos suspensos do Auto Scaling para o grupo do Auto Scaling especificado.**
```
Resume-ASProcess -AutoScalingGroupName my-asg
```
+ Para obter detalhes da API, consulte [ResumeProcesses](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Set-ASDesiredCapacity`
O código de exemplo a seguir mostra como usar `Set-ASDesiredCapacity`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Define o tamanho do grupo de Auto Scaling especificado.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2
```
**Exemplo 2: Este exemplo define o tamanho do grupo do Auto Scaling especificado e aguarda a conclusão do período de espera antes de fazer o escalonamento para o novo tamanho.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2 -HonorCooldown $true
```
+ Para obter detalhes da API, consulte [SetDesiredCapacity](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Set-ASInstanceHealth`
O código de exemplo a seguir mostra como usar `Set-ASInstanceHealth`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo define o status da instância especificada como “Não saudável”, tirando-a de serviço. O Auto Scaling termina e substitui a instância.**
```
Set-ASInstanceHealth -HealthStatus Unhealthy -InstanceId i-93633f9b
```
**Exemplo 2: Este exemplo define o status da instância especificada como “Saudável”, mantendo-a em serviço. Definir um período de carência da verificação de integridade para um grupo do Auto Scaling**
```
Set-ASInstanceHealth -HealthStatus Healthy -InstanceId i-93633f9b -ShouldRespectGracePeriod $false
```
+ Para obter detalhes da API, consulte [SetInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Set-ASInstanceProtection`
O código de exemplo a seguir mostra como usar `Set-ASInstanceProtection`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo habilita a proteção de instância na a instância especificada.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $true
```
**Exemplo 2: Este exemplo desabilita a proteção de instância na instância especificada.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $false
```
+ Para obter detalhes da API, consulte [SetInstanceProtection](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Set-ASTag`
O código de exemplo a seguir mostra como usar `Set-ASTag`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo adiciona uma única tag ao grupo do Auto Scaling especificado. A chave da tag é 'myTag' e o valor da tag é 'myTagValue'. O Auto Scaling propaga essa tag para as instâncias do EC2 subsequentes lançadas pelo grupo do Auto Scaling. A sintaxe usada neste exemplo requer a PowerShell versão 3 ou posterior.**
```
Set-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag"; Value="myTagValue"; PropagateAtLaunch=$true} )
```
**Exemplo 2: Com a PowerShell versão 2, você deve usar New-Object para criar a tag para o parâmetro 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
```
+ Para obter detalhes da API, consulte [CreateOrUpdateTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Start-ASPolicy`
O código de exemplo a seguir mostra como usar `Start-ASPolicy`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo executa a política especificada para o grupo do Auto Scaling especificado.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy"
```
**Exemplo 2: Este exemplo executa a política especificada para o grupo do Auto Scaling especificado, depois de aguardar a conclusão do período de espera.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy" -HonorCooldown $true
```
+ Para obter detalhes da API, consulte [ExecutePolicy](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Stop-ASInstanceInAutoScalingGroup`
O código de exemplo a seguir mostra como usar `Stop-ASInstanceInAutoScalingGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo encerra a instância especificada e diminui a capacidade desejada de seu grupo do Auto Scaling para que o Auto Scaling não inicie uma instância substituta.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $true
```
**Saída**:
```
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 :
```
**Exemplo 2: Este exemplo encerra a instância especificada sem diminuir a capacidade desejada de seu grupo do Auto Scaling. Auto Scaling inicia uma nova instância de substituição.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $false
```
**Saída**:
```
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 :
```
+ Para obter detalhes da API, consulte [TerminateInstanceInAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Suspend-ASProcess`
O código de exemplo a seguir mostra como usar `Suspend-ASProcess`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo suspende o processo de escalabilidade especificado para o grupo do Auto Scaling especificado.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Exemplo 2: Este exemplo suspende todos os processos do Auto Scaling para o grupo do Auto Scaling especificado.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg
```
+ Para obter detalhes da API, consulte [SuspendProcesses](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Update-ASAutoScalingGroup`
O código de exemplo a seguir mostra como usar `Update-ASAutoScalingGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo atualiza o tamanho mínimo e máximo do grupo do Auto Scaling especificado.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**Exemplo 2: Este exemplo atualiza o período de espera padrão do grupo do Auto Scaling especificado.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**Exemplo 3: Este exemplo atualiza as zonas de disponibilidade do grupo do Auto Scaling especificado.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**Exemplo 4: Este exemplo atualiza o grupo do Auto Scaling especificado para usar verificações de integridade do Elastic Load Balancing.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ Para obter detalhes da API, consulte [UpdateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Write-ASLifecycleActionHeartbeat`
O código de exemplo a seguir mostra como usar `Write-ASLifecycleActionHeartbeat`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo registra uma pulsação para a ação de ciclo de vida especificada. Isso mantém a instância em um estado pendente até que você conclua a ação personalizada.**
```
Write-ASLifecycleActionHeartbeat -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Para obter detalhes da API, consulte [RecordLifecycleActionHeartbeat](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Write-ASLifecycleHook`
O código de exemplo a seguir mostra como usar `Write-ASLifecycleHook`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo adiciona o gancho do ciclo de vida especificado ao grupo do Auto Scaling especificado.**
```
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"
```
+ Para obter detalhes da API, consulte [PutLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Write-ASNotificationConfiguration`
O código de exemplo a seguir mostra como usar `Write-ASNotificationConfiguration`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo configura o grupo do Auto Scaling especificado para enviar uma notificação ao tópico SNS especificado quando ele iniciar instâncias do EC2.**
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType "autoscaling:EC2_INSTANCE_LAUNCH" -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Exemplo 2: Este exemplo configura o grupo do Auto Scaling especificado para enviar uma notificação ao tópico SNS especificado quando ele iniciar ou encerrar instâncias do EC2.**
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType @("autoscaling:EC2_INSTANCE_LAUNCH", "autoscaling:EC2_INSTANCE_TERMINATE") -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
+ Para obter detalhes da API, consulte [PutNotificationConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Write-ASScalingPolicy`
O código de exemplo a seguir mostra como usar `Write-ASScalingPolicy`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo adiciona a política especificada ao grupo do Auto Scaling especificado. O tipo de ajuste especificado determina como interpretar o ScalingAdjustment parâmetro. Com 'ChangeInCapacity', um valor positivo aumenta a capacidade pelo número especificado de instâncias e um valor negativo diminui a capacidade pelo número especificado de instâncias.**
```
Write-ASScalingPolicy -AutoScalingGroupName my-asg -AdjustmentType "ChangeInCapacity" -PolicyName "myScaleInPolicy" -ScalingAdjustment -1
```
**Saída**:
```
arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:aa3836ab-5462-42c7-adab-e1d769fc24ef:autoScalingGroupName/my-asg
:policyName/myScaleInPolicy
```
+ Para obter detalhes da API, consulte [PutScalingPolicy](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Write-ASScheduledUpdateGroupAction`
O código de exemplo a seguir mostra como usar `Write-ASScheduledUpdateGroupAction`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo cria ou atualiza uma ação programada única para alterar a capacidade desejada na hora de início especificada.**
```
Write-ASScheduledUpdateGroupAction -AutoScalingGroupName my-asg -ScheduledActionName "myScheduledAction" -StartTime "2015-12-01T00:00:00Z" -DesiredCapacity 10
```
+ Para obter detalhes da API, consulte [PutScheduledUpdateGroupAction](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.