Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de Auto Scaling con Tools for PowerShell V5
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell V5 con Auto Scaling.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `Add-ASLoadBalancer`
En el siguiente ejemplo de código, se muestra cómo utilizar `Add-ASLoadBalancer`.
**Herramientas para la versión PowerShell 5**
**Ejemplo 1: En este ejemplo se asocia el equilibrador de carga especificado al grupo de escalado automático especificado.**
```
Add-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Para obtener más información sobre la API, consulte [AttachLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Complete-ASLifecycleAction`
En el siguiente ejemplo de código, se muestra cómo utilizar `Complete-ASLifecycleAction`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se completa la acción del ciclo de vida especificada.**
```
Complete-ASLifecycleAction -LifecycleHookName myLifecycleHook -AutoScalingGroupName my-asg -LifecycleActionResult CONTINUE -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Para obtener más información sobre la API, consulte [CompleteLifecycleAction](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Disable-ASMetricsCollection`
En el siguiente ejemplo de código, se muestra cómo utilizar `Disable-ASMetricsCollection`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se deshabilita la supervisión de las métricas especificadas para el grupo de escalado automático especificado.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg -Metric @("GroupMinSize", "GroupMaxSize")
```
**Ejemplo 2: En este ejemplo se deshabilita la supervisión de todas las métricas del grupo de escalado automático especificado.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg
```
+ Para obtener más información sobre la API, consulte [DisableMetricsCollection](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Dismount-ASInstance`
En el siguiente ejemplo de código, se muestra cómo utilizar `Dismount-ASInstance`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se desasocia la instancia especificada del grupo de escalado automático especificado y se reduce la capacidad deseada para que Auto Scaling no inicialice una instancia de sustitución.**
```
Dismount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Salida:**
```
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 :
```
**Ejemplo 2: En este ejemplo, se separa la instancia especificada del grupo de escalado automático especificado sin reducir la capacidad deseada. Auto Scaling inicializa una instancia de sustitución.**
```
Dismount-ASInstance -InstanceId i-7bf746a2 -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Salida:**
```
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 obtener más información sobre la API, consulte [DetachInstances](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Dismount-ASLoadBalancer`
En el siguiente ejemplo de código, se muestra cómo utilizar `Dismount-ASLoadBalancer`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se desasocia el equilibrador de carga especificado del grupo de escalado automático especificado.**
```
Dismount-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Para obtener más información sobre la API, consulte [DetachLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Enable-ASMetricsCollection`
En el siguiente ejemplo de código, se muestra cómo utilizar `Enable-ASMetricsCollection`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se habilita la supervisión de las métricas especificadas para el grupo de escalado automático especificado.**
```
Enable-ASMetricsCollection -Metric @("GroupMinSize", "GroupMaxSize") -AutoScalingGroupName my-asg -Granularity 1Minute
```
**Ejemplo 2: En este ejemplo se habilita la supervisión de todas las métricas del grupo de escalado automático especificado.**
```
Enable-ASMetricsCollection -AutoScalingGroupName my-asg -Granularity 1Minute
```
+ Para obtener más información sobre la API, consulte [EnableMetricsCollection](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Enter-ASStandby`
En el siguiente ejemplo de código, se muestra cómo utilizar `Enter-ASStandby`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se pone la instancia especificada en modo de espera y se reduce la capacidad deseada para que Auto Scaling no inicialice una instancia de sustitución.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Salida:**
```
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 :
```
**Ejemplo 2: En este ejemplo, se pone la instancia especificada en modo de espera sin reducir la capacidad deseada. Auto Scaling inicializa una instancia de sustitución.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Salida:**
```
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 obtener más información sobre la API, consulte [EnterStandby](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Exit-ASStandby`
En el siguiente ejemplo de código, se muestra cómo utilizar `Exit-ASStandby`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se saca la instancia especificada del modo de espera.**
```
Exit-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
**Salida:**
```
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 obtener más información sobre la API, consulte [ExitStandby](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASAccountLimit`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASAccountLimit`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Este ejemplo describe los límites de recursos de Auto Scaling para su AWS cuenta.**
```
Get-ASAccountLimit
```
**Salida:**
```
MaxNumberOfAutoScalingGroups : 20
MaxNumberOfLaunchConfigurations : 100
```
+ Para obtener más información sobre la API, consulte [DescribeAccountLimits Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*.
### `Get-ASAdjustmentType`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASAdjustmentType`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se describen los tipos de ajuste que son compatibles con el escalado automático.**
```
Get-ASAdjustmentType
```
**Salida:**
```
Type
----
ChangeInCapacity
ExactCapacity
PercentChangeInCapacity
```
+ Para obtener más información sobre la API, consulte [DescribeAdjustmentTypes](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASAutoScalingGroup`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASAutoScalingGroup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se enumeran los nombres de los grupos de escalado automático.**
```
Get-ASAutoScalingGroup | format-table -property AutoScalingGroupName
```
**Salida:**
```
AutoScalingGroupName
--------------------
my-asg-1
my-asg-2
my-asg-3
my-asg-4
my-asg-5
my-asg-6
```
**Ejemplo 2: En este ejemplo, se describe el grupo de escalado automático especificado.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1
```
**Salida:**
```
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
```
**Ejemplo 3: En este ejemplo, se describen los dos grupos de escalado automático especificados.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName @("my-asg-1", "my-asg-2")
```
**Ejemplo 4: En este ejemplo, se describen las instancias de escalado automático para el grupo de escalado automático especificado.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1).Instances
```
**Ejemplo 5: En este ejemplo se describen todos los grupos de escalado automático.**
```
Get-ASAutoScalingGroup
```
**Ejemplo 6: Este LaunchTemplate ejemplo describe el grupo de Auto Scaling especificado. En este ejemplo, se supone que las «Opciones de compra de instancias» están configuradas en «Adherirse a la plantilla de inicialización». En caso de que esta opción esté configurada como «Combinar opciones de compra y tipos de instancias», se LaunchTemplate puede acceder a ella mediante»MixedInstancesPolicy. LaunchTemplate«propiedad.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-ag-1).LaunchTemplate
```
**Salida:**
```
LaunchTemplateId LaunchTemplateName Version
---------------- ------------------ -------
lt-06095fd619cb40371 test-launch-template $Default
```
+ Para obtener más información sobre la API, consulte [DescribeAutoScalingGroups Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*.
### `Get-ASAutoScalingInstance`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASAutoScalingInstance`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se enumeran las instancias IDs de Auto Scaling.**
```
Get-ASAutoScalingInstance | format-table -property InstanceId
```
**Salida:**
```
InstanceId
----------
i-12345678
i-87654321
i-abcd1234
```
**Ejemplo 2: En este ejemplo se describe la instancia de escalado automático especificada.**
```
Get-ASAutoScalingInstance -InstanceId i-12345678
```
**Salida:**
```
AutoScalingGroupName : my-asg
AvailabilityZone : us-west-2b
HealthStatus : HEALTHY
InstanceId : i-12345678
LaunchConfigurationName : my-lc
LifecycleState : InService
```
**Ejemplo 3: En este ejemplo se describen las dos instancias de escalado automático especificadas.**
```
Get-ASAutoScalingInstance -InstanceId @("i-12345678", "i-87654321")
```
**Ejemplo 4: En este ejemplo, se describen las instancias de escalado automático para el grupo de escalado automático especificado.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg).Instances | Get-ASAutoScalingInstance
```
**Ejemplo 5: En este ejemplo se describen todas las instancias de escalado automático.**
```
Get-ASAutoScalingInstance
```
+ Para obtener más información sobre la API, consulte [DescribeAutoScalingInstances Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*.
### `Get-ASAutoScalingNotificationType`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASAutoScalingNotificationType`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se enumeran los tipos de notificaciones que son compatibles con el escalado automático.**
```
Get-ASAutoScalingNotificationType
```
**Salida:**
```
autoscaling:EC2_INSTANCE_LAUNCH
autoscaling:EC2_INSTANCE_LAUNCH_ERROR
autoscaling:EC2_INSTANCE_TERMINATE
autoscaling:EC2_INSTANCE_TERMINATE_ERROR
autoscaling:TEST_NOTIFICATION
```
+ Para obtener más información sobre la API, consulte [DescribeAutoScalingNotificationTypes](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASLaunchConfiguration`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASLaunchConfiguration`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se muestran los nombres de las configuraciones de inicialización.**
```
Get-ASLaunchConfiguration | format-table -property LaunchConfigurationName
```
**Salida:**
```
LaunchConfigurationName
-----------------------
my-lc-1
my-lc-2
my-lc-3
my-lc-4
my-lc-5
```
**Ejemplo 2: En este ejemplo se describe la configuración de inicialización especificada.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName my-lc-1
```
**Salida:**
```
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 :
```
**Ejemplo 3: En este ejemplo se describen las dos configuraciones de inicialización especificadas.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName @("my-lc-1", "my-lc-2")
```
**Ejemplo 4: En este ejemplo se describen todas las configuraciones de inicialización.**
```
Get-ASLaunchConfiguration
```
+ Para obtener más información sobre la API, consulte [DescribeLaunchConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASLifecycleHook`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASLifecycleHook`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se describe el enlace de ciclo de vida especificado.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Salida:**
```
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
```
**Ejemplo 2: En este ejemplo se describen los enlaces de ciclo de vida del grupo de escalado automático especificado.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg
```
**Ejemplo 3: En este ejemplo se describen todos los enlaces de ciclo de vida para todos los grupos de escalado automático.**
```
Get-ASLifecycleHook
```
+ Para obtener más información sobre la API, consulte [DescribeLifecycleHooks](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASLifecycleHookType`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASLifecycleHookType`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se enumeran los tipos de enlaces de ciclo de vida compatibles con el escalado automático.**
```
Get-ASLifecycleHookType
```
**Salida:**
```
autoscaling:EC2_INSTANCE_LAUNCHING
auto-scaling:EC2_INSTANCE_TERMINATING
```
+ Para obtener más información sobre la API, consulte [DescribeLifecycleHookTypes](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASLoadBalancer`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASLoadBalancer`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se describen los equilibradores de carga del grupo de escalado automático **especificado.
```
Get-ASLoadBalancer -AutoScalingGroupName my-asg
```
**Salida:**
```
LoadBalancerName State
---------------- -----
my-lb Added
```
+ Para obtener más información sobre la API, consulte [DescribeLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASMetricCollectionType`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASMetricCollectionType`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se enumeran los tipos de recopilación de métricas que admite el escalado automático.**
```
(Get-ASMetricCollectionType).Metrics
```
**Salida:**
```
Metric
------
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupTerminatingInstances
GroupStandbyInstances
GroupTotalInstances
```
**Ejemplo 2: En este ejemplo se enumeran las granularidades correspondientes.**
```
(Get-ASMetricCollectionType).Granularities
```
**Salida:**
```
Granularity
-----------
1Minute
```
+ Para obtener más información sobre la API, consulte [DescribeMetricCollectionTypes](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASNotificationConfiguration`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASNotificationConfiguration`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se describen las acciones de notificación asociadas al grupo de escalado automático especificado.**
```
Get-ASNotificationConfiguration -AutoScalingGroupName my-asg | format-list
```
**Salida:**
```
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
```
**Ejemplo 2: En este ejemplo se describen las acciones de notificación asociadas a todos los grupos de escalado automático.**
```
Get-ASNotificationConfiguration
```
+ Para obtener más información sobre la API, consulte [DescribeNotificationConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASPolicy`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASPolicy`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se describen todas las políticas para el grupo de escalado automático especificado.**
```
Get-ASPolicy -AutoScalingGroupName my-asg
```
**Salida:**
```
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 : {}
```
**Ejemplo 2: En este ejemplo se describen las políticas especificadas para el grupo de escalado automático especificado.**
```
Get-ASPolicy -AutoScalingGroupName my-asg -PolicyName @("myScaleOutPolicy", "myScaleInPolicy")
```
**Ejemplo 3: En este ejemplo se describen todas las políticas para todos los grupos de escalado automático.**
```
Get-ASPolicy
```
+ Para obtener más información sobre la API, consulte [DescribePolicies](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASScalingActivity`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASScalingActivity`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se describen actividades de escalado de las últimas de seis semanas para el grupo de escalado automático especificado.**
```
Get-ASScalingActivity -AutoScalingGroupName my-asg
```
**Salida:**
```
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 :
```
**Ejemplo 2: En este ejemplo se describe la actividad de escalado especificada.**
```
Get-ASScalingActivity -ActivityId "063308ae-aa22-4a9b-94f4-9fae4EXAMPLE"
```
**Ejemplo 3: En este ejemplo se describen las actividades de escalado de las últimas seis semanas para todos los grupos de escalado automático.**
```
Get-ASScalingActivity
```
+ Para obtener más información sobre la API, consulte [DescribeScalingActivities](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASScalingProcessType`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASScalingProcessType`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se enumeran los tipos de procesos que admite el escalado automático.**
```
Get-ASScalingProcessType
```
**Salida:**
```
ProcessName
-----------
AZRebalance
AddToLoadBalancer
AlarmNotification
HealthCheck
Launch
ReplaceUnhealthy
ScheduledActions
Terminate
```
+ Para obtener más información sobre la API, consulte [DescribeScalingProcessTypes](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASScheduledAction`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASScheduledAction`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se describen las acciones de escalado programadas para el grupo de escalado automático especificado.**
```
Get-ASScheduledAction -AutoScalingGroupName my-asg
```
**Salida:**
```
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
```
**Ejemplo 2: En este ejemplo, se describen las acciones de escalado programadas especificadas.**
```
Get-ASScheduledAction -ScheduledActionName @("myScheduledScaleOut", "myScheduledScaleIn")
```
**Ejemplo 3: En este ejemplo, se describen las acciones de escalado programadas que comienzan a la hora especificada.**
```
Get-ASScheduledAction -StartTime "2015-12-01T08:00:00Z"
```
**Ejemplo 4: En este ejemplo, se describen las acciones de escalado programadas que finalizan a la hora especificada.**
```
Get-ASScheduledAction -EndTime "2015-12-30T08:00:00Z"
```
**Ejemplo 5: En este ejemplo, se describen las acciones de escalado programadas para todos los grupos de escalado automático.**
```
Get-ASScheduledAction
```
+ Para obtener más información sobre la API, consulte [DescribeScheduledActions](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-ASTag`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASTag`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se describen las etiquetas con un valor clave de «myTag» o «myTag2». Los valores posibles para el nombre del filtro son auto-scaling-group '', 'clave', 'valor' y 'propagate-at-launch'. La sintaxis utilizada en este ejemplo requiere PowerShell la versión 3 o posterior.**
```
Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )
```
**Salida:**
```
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
```
**Ejemplo 2: Con la PowerShell versión 2, debe usar New-Object para crear el filtro para el 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 )
```
**Ejemplo 3: En este ejemplo se describen todas las etiquetas para todos los grupos de escalado automático.**
```
Get-ASTag
```
+ Para obtener más información sobre la API, consulte [DescribeTags Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference* (V5).
### `Get-ASTerminationPolicyType`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-ASTerminationPolicyType`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se enumeran las políticas de terminación compatibles con el escalado automático.**
```
Get-ASTerminationPolicyType
```
**Salida:**
```
ClosestToNextInstanceHour
Default
NewestInstance
OldestInstance
OldestLaunchConfiguration
```
+ Para obtener más información sobre la API, consulte [DescribeTerminationPolicyTypes](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Mount-ASInstance`
En el siguiente ejemplo de código, se muestra cómo utilizar `Mount-ASInstance`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se asocia la instancia especificada al grupo de escalado automático especificado. El escalado automático aumenta automáticamente la capacidad deseada del grupo de escalado automático.**
```
Mount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
+ Para obtener más información sobre la API, consulte [AttachInstances](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `New-ASAutoScalingGroup`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-ASAutoScalingGroup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se crea un grupo de escalado automático con el nombre y los atributos especificados. La capacidad deseada por defecto es el tamaño mínimo. Por lo tanto, este grupo de escalado automático inicializa dos instancias, una en cada una de las dos zonas de disponibilidad especificadas.**
```
New-ASAutoScalingGroup -AutoScalingGroupName my-asg -LaunchConfigurationName my-lc -MinSize 2 -MaxSize 6 -AvailabilityZone @("us-west-2a", "us-west-2b")
```
+ Para obtener más información sobre la API, consulte [CreateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `New-ASLaunchConfiguration`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-ASLaunchConfiguration`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se crea una configuración de inicialización denominada «my-lc». Las instancias de EC2 inicializadas por los grupos de escalado automático que utilizan esta configuración de inicialización utilizan un tipo de instancia, una AMI, un grupo de seguridad y un rol de IAM específicos.**
```
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"
```
+ Para obtener más información sobre la API, consulte [CreateLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-ASAutoScalingGroup`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-ASAutoScalingGroup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina el grupo de escalado automático especificado si no tiene instancias en ejecución. Se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg
```
**Salida:**
```
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"):
```
**Ejemplo 2: Si especifica el parámetro Force, no se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -Force
```
**Ejemplo 3: En este ejemplo se elimina el grupo de escalado automático especificado y se finalizan todas las instancias en ejecución que contenga.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -ForceDelete $true -Force
```
+ Para obtener más información sobre la API, consulte [DeleteAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-ASLaunchConfiguration`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-ASLaunchConfiguration`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina la configuración de inicialización especificada si no está asociada a un grupo de escalado automático. Se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc
```
**Salida:**
```
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"):
```
**Ejemplo 2: Si especifica el parámetro Force, no se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc -Force
```
+ Para obtener más información sobre la API, consulte [DeleteLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-ASLifecycleHook`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-ASLifecycleHook`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina el enlace de ciclo de vida especificado para el grupo de escalado automático especificado. Se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Salida:**
```
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"):
```
**Ejemplo 2: Si especifica el parámetro Force, no se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -Force
```
+ Para obtener más información sobre la API, consulte [DeleteLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-ASNotificationConfiguration`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-ASNotificationConfiguration`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina la acción de notificación especificada. Se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Salida:**
```
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"):
```
**Ejemplo 2: Si especifica el parámetro Force, no se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" -Force
```
+ Para obtener más información sobre la API, consulte [DeleteNotificationConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-ASPolicy`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-ASPolicy`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina la política especificada para el grupo de escalado automático especificado. Se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy
```
**Salida:**
```
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"):
```
**Ejemplo 2: Si especifica el parámetro Force, no se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy -Force
```
+ Para obtener más información sobre la API, consulte [DeletePolicy](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-ASScheduledAction`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-ASScheduledAction`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina la acción programada especificada para el grupo de escalado automático especificado. Se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction"
```
**Salida:**
```
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"):
```
**Ejemplo 2: Si especifica el parámetro Force, no se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction" -Force
```
+ Para obtener más información sobre la API, consulte [DeleteScheduledAction](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-ASTag`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-ASTag`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina la etiqueta especificada del grupo de escalado automático especificado. Se le solicitará una confirmación antes de continuar con la operación. La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o posterior.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } )
```
**Salida:**
```
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"):
```
**Ejemplo 2: Si especifica el parámetro Force, no se le solicitará una confirmación antes de continuar con la operación.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } ) -Force
```
**Ejemplo 3: Con la versión 2 de PowerShell, debe usar New-Object para crear la etiqueta para el parámetro Etiqueta.**
```
$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 obtener más información sobre la API, consulte [DeleteTags Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*.
### `Resume-ASProcess`
En el siguiente ejemplo de código, se muestra cómo utilizar `Resume-ASProcess`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se reanuda el proceso de escalado automático especificado para el grupo de escalado automático especificado.**
```
Resume-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Ejemplo 2: En este ejemplo se reanudan todos los procesos de escalado automático suspendidos para el grupo de escalado automático especificado.**
```
Resume-ASProcess -AutoScalingGroupName my-asg
```
+ Para obtener más información sobre la API, consulte [ResumeProcesses](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Set-ASDesiredCapacity`
En el siguiente ejemplo de código, se muestra cómo utilizar `Set-ASDesiredCapacity`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se establece el tamaño del grupo de escalado automático especificado.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2
```
**Ejemplo 2: En este ejemplo se establece el tamaño del grupo de escalado automático especificado y espera a que finalice el período de recuperación antes de escalar al nuevo tamaño.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2 -HonorCooldown $true
```
+ Para obtener más información sobre la API, consulte [SetDesiredCapacity](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Set-ASInstanceHealth`
En el siguiente ejemplo de código, se muestra cómo utilizar `Set-ASInstanceHealth`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se establece el estado de la instancia especificada en «Mal estado», por lo que queda fuera de servicio. El escalado automático finaliza y reemplaza la instancia.**
```
Set-ASInstanceHealth -HealthStatus Unhealthy -InstanceId i-93633f9b
```
**Ejemplo 2: En este ejemplo, se establece el estado de la instancia especificada en «Buen estado» y se mantiene en servicio. No se respeta ningún periodo de gracia de la comprobación de estado para un grupo de escalado automático.**
```
Set-ASInstanceHealth -HealthStatus Healthy -InstanceId i-93633f9b -ShouldRespectGracePeriod $false
```
+ Para obtener más información sobre la API, consulte [SetInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Set-ASInstanceProtection`
En el siguiente ejemplo de código, se muestra cómo utilizar `Set-ASInstanceProtection`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se habilita la protección de instancias para la instancia especificada.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $true
```
**Ejemplo 2: En este ejemplo se deshabilita la protección de instancias para la instancia especificada.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $false
```
+ Para obtener más información sobre la API, consulte [SetInstanceProtection](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Set-ASTag`
En el siguiente ejemplo de código, se muestra cómo utilizar `Set-ASTag`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se agrega una etiqueta única al grupo de escalado automático especificado. La clave de la etiqueta es 'myTag' y el valor de la etiqueta es ''. myTagValue El escalado automático propaga esta etiqueta a las siguientes instancias de EC2 inicializadas por el grupo de escalado automático. La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o posterior.**
```
Set-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag"; Value="myTagValue"; PropagateAtLaunch=$true} )
```
**Ejemplo 2: Con la PowerShell versión 2, debe usar New-Object para crear la etiqueta para el 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 obtener más información sobre la API, consulte [CreateOrUpdateTags Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference* (V5).
### `Start-ASPolicy`
En el siguiente ejemplo de código, se muestra cómo utilizar `Start-ASPolicy`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se ejecuta la política especificada para el grupo de escalado automático especificado.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy"
```
**Ejemplo 2: En este ejemplo se ejecuta la política especificada para el grupo de escalado automático especificado, después de esperar a que finalice el período de recuperación.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy" -HonorCooldown $true
```
+ Para obtener más información sobre la API, consulte [ExecutePolicy](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Stop-ASInstanceInAutoScalingGroup`
En el siguiente ejemplo de código, se muestra cómo utilizar `Stop-ASInstanceInAutoScalingGroup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se termina la instancia especificada y se reduce la capacidad deseada de su grupo de escalado automático para que Auto Scaling no inicialice una instancia de sustitución.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $true
```
**Salida:**
```
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 :
```
**Ejemplo 2: En este ejemplo, se termina la instancia especificada sin disminuir la capacidad deseada de su grupo de escalado automático. Auto Scaling inicializa una instancia de remplazo.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $false
```
**Salida:**
```
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 obtener más información sobre la API, consulte [TerminateInstanceInAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Suspend-ASProcess`
En el siguiente ejemplo de código, se muestra cómo utilizar `Suspend-ASProcess`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se suspende el proceso de escalado automático especificado para el grupo de escalado automático especificado.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Ejemplo 2: En este ejemplo se suspenden todos los procesos de escalado automático para el grupo de escalado automático especificado.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg
```
+ Para obtener más información sobre la API, consulte [SuspendProcesses](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Update-ASAutoScalingGroup`
En el siguiente ejemplo de código, se muestra cómo utilizar `Update-ASAutoScalingGroup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo, se actualiza el tamaño mínimo y máximo del grupo de escalado automático especificado.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**Ejemplo 2: En este ejemplo se actualiza el período de recuperación predeterminado del grupo de escalado automático especificado.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**Ejemplo 3: En este ejemplo se actualizan las zonas de disponibilidad del grupo de escalado automático especificado.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**Ejemplo 4: En este ejemplo, se actualiza el grupo de escalado automático especificado para utilizar comprobaciones de estado de Elastic Load Balancing.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ Para obtener más información sobre la API, consulte [UpdateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Write-ASLifecycleActionHeartbeat`
En el siguiente ejemplo de código, se muestra cómo utilizar `Write-ASLifecycleActionHeartbeat`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se registra un latido para la acción del ciclo de vida especificada. Esto mantiene la instancia en estado pendiente hasta que complete la acción personalizada.**
```
Write-ASLifecycleActionHeartbeat -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Para obtener más información sobre la API, consulte [RecordLifecycleActionHeartbeat](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Write-ASLifecycleHook`
En el siguiente ejemplo de código, se muestra cómo utilizar `Write-ASLifecycleHook`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se agrega el enlace de ciclo de vida especificado al grupo de escalado automático 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 obtener más información sobre la API, consulte [PutLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Write-ASNotificationConfiguration`
En el siguiente ejemplo de código, se muestra cómo utilizar `Write-ASNotificationConfiguration`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se configura el grupo de escalado automático especificado para enviar una notificación al tema de SNS especificado cuando inicialice instancias de EC2.**
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType "autoscaling:EC2_INSTANCE_LAUNCH" -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Ejemplo 2: En este ejemplo se configura el grupo de escalado automático especificado para enviar una notificación al tema de SNS especificado cuando inicialice o finalice las instancias de 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 obtener más información sobre la API, consulte [PutNotificationConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Write-ASScalingPolicy`
En el siguiente ejemplo de código, se muestra cómo utilizar `Write-ASScalingPolicy`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se agrega la política especificada al grupo de escalado automático especificado. El tipo de ajuste especificado determina cómo interpretar el ScalingAdjustment parámetro. Con 'ChangeInCapacity', un valor positivo aumenta la capacidad en el número especificado de instancias y un valor negativo reduce la capacidad en el número especificado de instancias.**
```
Write-ASScalingPolicy -AutoScalingGroupName my-asg -AdjustmentType "ChangeInCapacity" -PolicyName "myScaleInPolicy" -ScalingAdjustment -1
```
**Salida:**
```
arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:aa3836ab-5462-42c7-adab-e1d769fc24ef:autoScalingGroupName/my-asg
:policyName/myScaleInPolicy
```
+ Para obtener más información sobre la API, consulte [PutScalingPolicy Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*.
### `Write-ASScheduledUpdateGroupAction`
En el siguiente ejemplo de código, se muestra cómo utilizar `Write-ASScheduledUpdateGroupAction`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se crea o actualiza una acción programada única para cambiar la capacidad deseada a la hora de inicio especificada.**
```
Write-ASScheduledUpdateGroupAction -AutoScalingGroupName my-asg -ScheduledActionName "myScheduledAction" -StartTime "2015-12-01T00:00:00Z" -DesiredCapacity 10
```
+ Para obtener más información sobre la API, consulte [PutScheduledUpdateGroupAction](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).