のバージョン 5 (V5) AWS Tools for PowerShell がリリースされました。 重要な変更とアプリケーションの移行については、[「移行トピック](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)」を参照してください。 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Tools for PowerShell V5 を使用した Auto Scaling の例 次のコード例は、Auto Scaling で AWS Tools for PowerShell V5 を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。 *アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。 各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。 **Topics** + [アクション](#actions) ## アクション ### `Add-ASLoadBalancer` 次のコード例は、`Add-ASLoadBalancer` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したロードバランサーを、指定した Auto Scaling グループにアタッチします。** ``` Add-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[AttachLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Complete-ASLifecycleAction` 次のコード例は、`Complete-ASLifecycleAction` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したライフサイクルアクションを完了します。** ``` Complete-ASLifecycleAction -LifecycleHookName myLifecycleHook -AutoScalingGroupName my-asg -LifecycleActionResult CONTINUE -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[CompleteLifecycleAction](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Disable-ASMetricsCollection` 次のコード例は、`Disable-ASMetricsCollection` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの指定したメトリクスのモニタリングを無効にします。** ``` Disable-ASMetricsCollection -AutoScalingGroupName my-asg -Metric @("GroupMinSize", "GroupMaxSize") ``` **例 2: この例では、指定した Auto Scaling グループのすべてのメトリクスのモニタリングを無効にします。** ``` Disable-ASMetricsCollection -AutoScalingGroupName my-asg ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DisableMetricsCollection](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Dismount-ASInstance` 次のコード例は、`Dismount-ASInstance` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループから指定したインスタンスをデタッチし、希望する容量を減らして、Auto Scaling が代替インスタンスを起動しないようにします。** ``` Dismount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true ``` **出力:** ``` 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 : ``` **例 2: この例では、希望する容量を減らすことなく、指定したインスタンスを指定した Auto Scaling グループからデタッチします。Auto Scaling が代替インスタンスを起動します。** ``` Dismount-ASInstance -InstanceId i-7bf746a2 -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false ``` **出力:** ``` 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 : ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DetachInstances](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Dismount-ASLoadBalancer` 次のコード例は、`Dismount-ASLoadBalancer` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループから指定したロードバランサーをデタッチします。** ``` Dismount-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DetachLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Enable-ASMetricsCollection` 次のコード例は、`Enable-ASMetricsCollection` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの指定したメトリクスのモニタリングを有効にします。** ``` Enable-ASMetricsCollection -Metric @("GroupMinSize", "GroupMaxSize") -AutoScalingGroupName my-asg -Granularity 1Minute ``` **例 2: この例では、指定した Auto Scaling グループのすべてのメトリクスのモニタリングを有効にします。** ``` Enable-ASMetricsCollection -AutoScalingGroupName my-asg -Granularity 1Minute ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[EnableMetricsCollection](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Enter-ASStandby` 次のコード例は、`Enter-ASStandby` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したインスタンスをスタンバイモードにし、希望する容量を減らして、Auto Scaling が代替インスタンスを起動しないようにします。** ``` Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true ``` **出力:** ``` 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 : ``` **例 2: この例では、希望する容量を減らすことなく、指定したインスタンスをスタンバイモードにします。Auto Scaling が代替インスタンスを起動します。** ``` Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false ``` **出力:** ``` 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 : ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[EnterStandby](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Exit-ASStandby` 次のコード例は、`Exit-ASStandby` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したインスタンスをスタンバイモードから解除します。** ``` Exit-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg ``` **出力:** ``` 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 : ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[ExitStandby](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASAccountLimit` 次のコード例は、`Get-ASAccountLimit` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、 AWS アカウントの Auto Scaling リソース制限について説明します。** ``` Get-ASAccountLimit ``` **出力:** ``` MaxNumberOfAutoScalingGroups : 20 MaxNumberOfLaunchConfigurations : 100 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeAccountLimits](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASAdjustmentType` 次のコード例は、`Get-ASAdjustmentType` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、Auto Scaling でサポートされている調整タイプを記述します。** ``` Get-ASAdjustmentType ``` **出力:** ``` Type ---- ChangeInCapacity ExactCapacity PercentChangeInCapacity ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeAdjustmentTypes](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASAutoScalingGroup` 次のコード例は、`Get-ASAutoScalingGroup` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、Auto Scaling グループの名前を一覧表示します。** ``` Get-ASAutoScalingGroup | format-table -property AutoScalingGroupName ``` **出力:** ``` AutoScalingGroupName -------------------- my-asg-1 my-asg-2 my-asg-3 my-asg-4 my-asg-5 my-asg-6 ``` **例 2: この例では、指定した Auto Scaling グループを記述します。** ``` Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1 ``` **出力:** ``` 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 ``` **例 3: この例では、指定した 2 つの Auto Scaling グループを記述します。** ``` Get-ASAutoScalingGroup -AutoScalingGroupName @("my-asg-1", "my-asg-2") ``` **例 4: この例では、指定した Auto Scaling グループの Auto Scaling インスタンスを記述します。** ``` (Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1).Instances ``` **例 5: この例では、すべての Auto Scaling グループを記述します。** ``` Get-ASAutoScalingGroup ``` **例 6: この例では、指定した Auto Scaling グループ用の起動テンプレートを記述します。この例では、[インスタンスの購入オプション] が [起動テンプレートに準拠する] に設定されていることを前提としています。このオプションが [購入オプションとインスタンスタイプを組み合わせる] に設定されている場合、LaunchTemplate には「MixedInstancesPolicy.LaunchTemplate」プロパティを使用してアクセスできます。** ``` (Get-ASAutoScalingGroup -AutoScalingGroupName my-ag-1).LaunchTemplate ``` **出力:** ``` LaunchTemplateId LaunchTemplateName Version ---------------- ------------------ ------- lt-06095fd619cb40371 test-launch-template $Default ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeAutoScalingGroups](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASAutoScalingInstance` 次のコード例は、`Get-ASAutoScalingInstance` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例は、Auto Scaling インスタンスの ID を一覧表示します。** ``` Get-ASAutoScalingInstance | format-table -property InstanceId ``` **出力:** ``` InstanceId ---------- i-12345678 i-87654321 i-abcd1234 ``` **例 2: この例では、指定した Auto Scaling インスタンスを記述します。** ``` Get-ASAutoScalingInstance -InstanceId i-12345678 ``` **出力:** ``` AutoScalingGroupName : my-asg AvailabilityZone : us-west-2b HealthStatus : HEALTHY InstanceId : i-12345678 LaunchConfigurationName : my-lc LifecycleState : InService ``` **例 3: この例では、指定した 2 つの Auto Scaling インスタンスを記述します。** ``` Get-ASAutoScalingInstance -InstanceId @("i-12345678", "i-87654321") ``` **例 4: この例では、指定した Auto Scaling グループの Auto Scaling インスタンスを記述します。** ``` (Get-ASAutoScalingGroup -AutoScalingGroupName my-asg).Instances | Get-ASAutoScalingInstance ``` **例 5: この例では、すべての Auto Scaling インスタンスを記述します。** ``` Get-ASAutoScalingInstance ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeAutoScalingInstances](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASAutoScalingNotificationType` 次のコード例は、`Get-ASAutoScalingNotificationType` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、Auto Scaling でサポートされている通知タイプを一覧表示します。** ``` Get-ASAutoScalingNotificationType ``` **出力:** ``` autoscaling:EC2_INSTANCE_LAUNCH autoscaling:EC2_INSTANCE_LAUNCH_ERROR autoscaling:EC2_INSTANCE_TERMINATE autoscaling:EC2_INSTANCE_TERMINATE_ERROR autoscaling:TEST_NOTIFICATION ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeAutoScalingNotificationTypes](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASLaunchConfiguration` 次のコード例は、`Get-ASLaunchConfiguration` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、起動設定の名前を一覧表示します。** ``` Get-ASLaunchConfiguration | format-table -property LaunchConfigurationName ``` **出力:** ``` LaunchConfigurationName ----------------------- my-lc-1 my-lc-2 my-lc-3 my-lc-4 my-lc-5 ``` **例 2: この例では、指定した起動設定を記述します。** ``` Get-ASLaunchConfiguration -LaunchConfigurationName my-lc-1 ``` **出力:** ``` 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 : ``` **例 3: この例では、指定した 2 つの起動設定を記述します。** ``` Get-ASLaunchConfiguration -LaunchConfigurationName @("my-lc-1", "my-lc-2") ``` **例 4: この例では、すべての起動設定を記述します。** ``` Get-ASLaunchConfiguration ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeLaunchConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASLifecycleHook` 次のコード例は、`Get-ASLifecycleHook` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したライフサイクルフックを記述します。** ``` Get-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook ``` **出力:** ``` 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 ``` **例 2: この例では、指定した Auto Scaling グループのすべてのライフサイクルフックを記述します。** ``` Get-ASLifecycleHook -AutoScalingGroupName my-asg ``` **例 3: この例では、すべての Auto Scaling グループのすべてのライフサイクルフックを記述します。** ``` Get-ASLifecycleHook ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeLifecycleHooks](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASLifecycleHookType` 次のコード例は、`Get-ASLifecycleHookType` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例は、Auto Scaling でサポートされているライフサイクルフックの種類を一覧表示します。** ``` Get-ASLifecycleHookType ``` **出力:** ``` autoscaling:EC2_INSTANCE_LAUNCHING auto-scaling:EC2_INSTANCE_TERMINATING ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeLifecycleHookTypes](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASLoadBalancer` 次のコード例は、`Get-ASLoadBalancer` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループのロードバランサーを記述します。** ``` Get-ASLoadBalancer -AutoScalingGroupName my-asg ``` **出力:** ``` LoadBalancerName State ---------------- ----- my-lb Added ``` + API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[DescribeLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。** ### `Get-ASMetricCollectionType` 次のコード例は、`Get-ASMetricCollectionType` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、Auto Scaling でサポートされているメトリクスコレクションタイプを一覧表示します。** ``` (Get-ASMetricCollectionType).Metrics ``` **出力:** ``` Metric ------ GroupMinSize GroupMaxSize GroupDesiredCapacity GroupInServiceInstances GroupPendingInstances GroupTerminatingInstances GroupStandbyInstances GroupTotalInstances ``` **例 2: この例では、対応する粒度を一覧表示します。** ``` (Get-ASMetricCollectionType).Granularities ``` **出力:** ``` Granularity ----------- 1Minute ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeMetricCollectionTypes](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASNotificationConfiguration` 次のコード例は、`Get-ASNotificationConfiguration` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループに関連付けられている通知アクションを記述します。** ``` Get-ASNotificationConfiguration -AutoScalingGroupName my-asg | format-list ``` **出力:** ``` 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 ``` **例 2: この例では、すべての Auto Scaling グループに関連付けられている通知アクションを記述します。** ``` Get-ASNotificationConfiguration ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeNotificationConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASPolicy` 次のコード例は、`Get-ASPolicy` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループのすべてのポリシーを記述します。** ``` Get-ASPolicy -AutoScalingGroupName my-asg ``` **出力:** ``` 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 : {} ``` **例 2: この例では、指定した Auto Scaling グループの指定したポリシーを記述します。** ``` Get-ASPolicy -AutoScalingGroupName my-asg -PolicyName @("myScaleOutPolicy", "myScaleInPolicy") ``` **例 3: この例では、すべての Auto Scaling グループのすべてのポリシーを記述します。** ``` Get-ASPolicy ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribePolicies](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASScalingActivity` 次のコード例は、`Get-ASScalingActivity` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: こので例は、指定した Auto Scaling グループの過去 6 週間のスケーリングアクティビティを記述します。** ``` Get-ASScalingActivity -AutoScalingGroupName my-asg ``` **出力:** ``` 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 : ``` **例 2: この例では、指定したスケーリングアクティビティを記述します。** ``` Get-ASScalingActivity -ActivityId "063308ae-aa22-4a9b-94f4-9fae4EXAMPLE" ``` **例 3: この例では、すべての Auto Scaling グループの過去 6 週間のスケーリングアクティビティを記述します。** ``` Get-ASScalingActivity ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeScalingActivities](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASScalingProcessType` 次のコード例は、`Get-ASScalingProcessType` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、Auto Scaling でサポートされているプロセスタイプを一覧表示します。** ``` Get-ASScalingProcessType ``` **出力:** ``` ProcessName ----------- AZRebalance AddToLoadBalancer AlarmNotification HealthCheck Launch ReplaceUnhealthy ScheduledActions Terminate ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeScalingProcessTypes](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASScheduledAction` 次のコード例は、`Get-ASScheduledAction` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループのスケジュールされたスケーリングアクティビティを記述します。** ``` Get-ASScheduledAction -AutoScalingGroupName my-asg ``` **出力:** ``` 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 ``` **例 2: この例では、指定したスケジュールされたスケーリングアクションを記述します。** ``` Get-ASScheduledAction -ScheduledActionName @("myScheduledScaleOut", "myScheduledScaleIn") ``` **例 3: この例では、指定した時刻までに開始されるスケジュールされたスケーリングアクションを記述します。** ``` Get-ASScheduledAction -StartTime "2015-12-01T08:00:00Z" ``` **例 4: この例では、指定した時刻までに終了するスケジュールされたスケーリングアクションを記述します。** ``` Get-ASScheduledAction -EndTime "2015-12-30T08:00:00Z" ``` **例 5: この例では、すべての Auto Scaling グループのスケジュールされたスケーリングアクションを記述します。** ``` Get-ASScheduledAction ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeScheduledActions](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASTag` 次のコード例は、`Get-ASTag` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、キー値が「myTag」または「myTag2」のタグを記述します。フィルター名に使用できる値は、「auto-scaling-group」、「key」、「value」、および「propagate-at-launch」です。この例で使用される構文には、PowerShell バージョン 3 以降が必要です。** ``` Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } ) ``` **出力:** ``` 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 ``` **例 2: PowerShell バージョン 2 では、New-Object を使用してフィルターパラメータのフィルターを作成する必要があります。** ``` $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 ) ``` **例 3: この例では、すべての Auto Scaling グループのすべてのタグを記述します。** ``` Get-ASTag ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-ASTerminationPolicyType` 次のコード例は、`Get-ASTerminationPolicyType` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、Auto Scaling でサポートされている終了ポリシーを一覧表示します。** ``` Get-ASTerminationPolicyType ``` **出力:** ``` ClosestToNextInstanceHour Default NewestInstance OldestInstance OldestLaunchConfiguration ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeTerminationPolicyTypes](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Mount-ASInstance` 次のコード例は、`Mount-ASInstance` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したインスタンスを、指定した Auto Scaling グループにアタッチします。Auto Scaling は、Auto Scaling グループの希望する容量を自動的に増やします。** ``` Mount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[AttachInstances](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `New-ASAutoScalingGroup` 次のコード例は、`New-ASAutoScalingGroup` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した名前と属性で Auto Scaling グループを作成します。デフォルトの希望する容量は最小サイズになります。したがって、この Auto Scaling グループは、指定した 2 つのアベイラビリティーゾーンのそれぞれに 1 つずつ、合計 2 つのインスタンスを起動します。** ``` New-ASAutoScalingGroup -AutoScalingGroupName my-asg -LaunchConfigurationName my-lc -MinSize 2 -MaxSize 6 -AvailabilityZone @("us-west-2a", "us-west-2b") ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[CreateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `New-ASLaunchConfiguration` 次のコード例は、`New-ASLaunchConfiguration` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、「my-lc」という名前の起動設定を作成します。この起動設定を使用する Auto Scaling グループによって起動された EC2 インスタンスは、指定されたインスタンスタイプ、AMI、セキュリティグループ、および IAM ロールを使用します。** ``` New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole" ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[CreateLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-ASAutoScalingGroup` 次のコード例は、`Remove-ASAutoScalingGroup` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループに実行中のインスタンスがない場合、そのグループを削除します。操作を続行する前に確認画面が表示されます。** ``` Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg ``` **出力:** ``` 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"): ``` **例 2: Force パラメータを指定すると、操作を続行する前に確認を求めるプロンプトが表示されません。** ``` Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -Force ``` **例 3: この例では、指定した Auto Scaling グループを削除し、そのグループに含まれる実行中のインスタンスをすべて終了します。** ``` Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -ForceDelete $true -Force ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-ASLaunchConfiguration` 次のコード例は、`Remove-ASLaunchConfiguration` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した起動設定が Auto Scaling グループにアタッチされていない場合、そのグループを削除します。操作を続行する前に確認画面が表示されます。** ``` Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc ``` **出力:** ``` 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"): ``` **例 2: Force パラメータを指定すると、操作を続行する前に確認を求めるプロンプトが表示されません。** ``` Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc -Force ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteLaunchConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-ASLifecycleHook` 次のコード例は、`Remove-ASLifecycleHook` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの指定したライフサイクルフックを削除します。操作を続行する前に確認画面が表示されます。** ``` Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook ``` **出力:** ``` 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"): ``` **例 2: Force パラメータを指定すると、操作を続行する前に確認を求めるプロンプトが表示されません。** ``` Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -Force ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-ASNotificationConfiguration` 次のコード例は、`Remove-ASNotificationConfiguration` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した通知アクションを削除します。操作を続行する前に確認画面が表示されます。** ``` Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" ``` **出力:** ``` 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"): ``` **例 2: Force パラメータを指定すると、操作を続行する前に確認を求めるプロンプトが表示されません。** ``` Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" -Force ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteNotificationConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-ASPolicy` 次のコード例は、`Remove-ASPolicy` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの指定したポリシーを削除します。操作を続行する前に確認画面が表示されます。** ``` Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy ``` **出力:** ``` 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"): ``` **例 2: Force パラメータを指定すると、操作を続行する前に確認を求めるプロンプトが表示されません。** ``` Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy -Force ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeletePolicy](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-ASScheduledAction` 次のコード例は、`Remove-ASScheduledAction` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの指定したスケジュールされたアクションを削除します。操作を続行する前に確認画面が表示されます。** ``` Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction" ``` **出力:** ``` 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"): ``` **例 2: Force パラメータを指定すると、操作を続行する前に確認を求めるプロンプトが表示されません。** ``` Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction" -Force ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteScheduledAction](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-ASTag` 次のコード例は、`Remove-ASTag` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループから指定したタグを削除します。操作を続行する前に確認画面が表示されます。この例で使用される構文には、PowerShell バージョン 3 以降が必要です。** ``` Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } ) ``` **出力:** ``` 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"): ``` **例 2: Force パラメータを指定すると、操作を続行する前に確認を求めるプロンプトが表示されません。** ``` Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } ) -Force ``` **例 3: PowerShell バージョン 2 では、New-Object を使用してタグパラメータのタグを作成する必要があります。** ``` $tag = New-Object Amazon.AutoScaling.Model.Tag $tag.ResourceType = "auto-scaling-group" $tag.ResourceId = "my-asg" $tag.Key = "myTag" Remove-ASTag -Tag $tag -Force ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Resume-ASProcess` 次のコード例は、`Resume-ASProcess` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの指定した Auto Scaling プロセスを再開します。** ``` Resume-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification" ``` **例 2: この例では、指定した Auto Scaling グループの中断されたすべての Auto Scaling プロセスを再開します。** ``` Resume-ASProcess -AutoScalingGroupName my-asg ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[ResumeProcesses](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Set-ASDesiredCapacity` 次のコード例は、`Set-ASDesiredCapacity` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループのサイズを設定します。** ``` Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2 ``` **例 2: この例では、指定した Auto Scaling グループのサイズを設定し、クールダウン期間が完了するまで待ってから、新しいサイズにスケールします。** ``` Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2 -HonorCooldown $true ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[SetDesiredCapacity](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Set-ASInstanceHealth` 次のコード例は、`Set-ASInstanceHealth` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したインスタンスのステータスを「Unhealthy」に設定し、使用を中止します。Auto Scaling はインスタンスを終了して置き換えます。** ``` Set-ASInstanceHealth -HealthStatus Unhealthy -InstanceId i-93633f9b ``` **例 2: この例では、指定したインスタンスのステータスを「Healthy」に設定し、そのまま稼働させます。Auto Scaling グループのヘルスチェック猶予期間は無視されます。** ``` Set-ASInstanceHealth -HealthStatus Healthy -InstanceId i-93633f9b -ShouldRespectGracePeriod $false ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[SetInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Set-ASInstanceProtection` 次のコード例は、`Set-ASInstanceProtection` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したインスタンスのインスタンス保護を有効にします。** ``` Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $true ``` **例 2: この例では、指定したインスタンスのインスタンス保護を無効にします。** ``` Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $false ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[SetInstanceProtection](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Set-ASTag` 次のコード例は、`Set-ASTag` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループに単一のタグを追加します。タグキーは「myTag」で、タグ値は「myTagValue」です。Auto Scaling は、このタグを Auto Scaling グループによって起動された後続の EC2 インスタンスに伝播します。この例で使用される構文には、PowerShell バージョン 3 以降が必要です。** ``` Set-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag"; Value="myTagValue"; PropagateAtLaunch=$true} ) ``` **例 2: PowerShell バージョン 2 では、New-Object を使用してタグパラメータのタグを作成する必要があります。** ``` $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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)*の「[CreateOrUpdateTags](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Start-ASPolicy` 次のコード例は、`Start-ASPolicy` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの指定したポリシーを実行します。** ``` Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy" ``` **例 2: この例では、クールダウン期間が完了するまで待機した後、指定した Auto Scaling グループの指定したポリシーを実行します。** ``` Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy" -HonorCooldown $true ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[ExecutePolicy](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Stop-ASInstanceInAutoScalingGroup` 次のコード例は、`Stop-ASInstanceInAutoScalingGroup` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したインスタンスを終了し、Auto Scaling グループの希望する容量を減らして、Auto Scaling が代替インスタンスを起動しないようにします。** ``` Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $true ``` **出力:** ``` 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 : ``` **例 2: この例では、Auto Scaling グループの希望する容量を減らすことなく、指定したインスタンスを終了します。Auto Scaling が代替インスタンスを起動します。** ``` Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $false ``` **出力:** ``` 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 : ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[TerminateInstanceInAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Suspend-ASProcess` 次のコード例は、`Suspend-ASProcess` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの指定した Auto Scaling プロセスを中断します。** ``` Suspend-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification" ``` **例 2: この例では、指定した Auto Scaling グループのすべての Auto Scaling プロセスを中断します。** ``` Suspend-ASProcess -AutoScalingGroupName my-asg ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[SuspendProcesses](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Update-ASAutoScalingGroup` 次のコード例は、`Update-ASAutoScalingGroup` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループの最小サイズと最大サイズを更新します。** ``` Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1 ``` **例 2: この例では、指定した Auto Scaling グループのデフォルトのクールダウン期間を更新します。** ``` Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10 ``` **例 3: この例では、指定した Auto Scaling グループのアベイラビリティーゾーンを更新します。** ``` Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b") ``` **例 4: この例では、指定した Auto Scaling グループを更新して、Elastic Load Balancing のヘルスチェックを使用します。** ``` Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[UpdateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Write-ASLifecycleActionHeartbeat` 次のコード例は、`Write-ASLifecycleActionHeartbeat` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したライフサイクルアクションのハートビートを記録します。これにより、カスタムアクションが完了するまでインスタンスは保留中の状態になります。** ``` Write-ASLifecycleActionHeartbeat -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[RecordLifecycleActionHeartbeat](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Write-ASLifecycleHook` 次のコード例は、`Write-ASLifecycleHook` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定したライフサイクルフックを、指定した Auto Scaling グループに追加します。** ``` 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" ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[PutLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Write-ASNotificationConfiguration` 次のコード例は、`Write-ASNotificationConfiguration` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループが、EC2 インスタンスの起動時に指定した SNS トピックに通知を送信するように設定します。** ``` Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType "autoscaling:EC2_INSTANCE_LAUNCH" -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" ``` **例 2: この例では、指定した Auto Scaling グループが、EC2 インスタンスの起動または終了時に、指定した SNS トピックに通知を送信するように設定します。** ``` Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType @("autoscaling:EC2_INSTANCE_LAUNCH", "autoscaling:EC2_INSTANCE_TERMINATE") -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[PutNotificationConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Write-ASScalingPolicy` 次のコード例は、`Write-ASScalingPolicy` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、指定した Auto Scaling グループに指定したポリシーを追加します。指定した調整タイプによって、ScalingAdjustment パラメータの解釈方法が決まります。「ChangeInCapacity」では、正の値を指定すると、指定したインスタンス数だけ容量が増え、負の値を指定すると、指定したインスタンス数だけ容量が減ります。** ``` Write-ASScalingPolicy -AutoScalingGroupName my-asg -AdjustmentType "ChangeInCapacity" -PolicyName "myScaleInPolicy" -ScalingAdjustment -1 ``` **出力:** ``` arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:aa3836ab-5462-42c7-adab-e1d769fc24ef:autoScalingGroupName/my-asg :policyName/myScaleInPolicy ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[PutScalingPolicy](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Write-ASScheduledUpdateGroupAction` 次のコード例は、`Write-ASScheduledUpdateGroupAction` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: この例では、1 回限りのスケジュールされたアクションを作成または更新して、指定した開始時刻に希望する容量を変更します。** ``` Write-ASScheduledUpdateGroupAction -AutoScalingGroupName my-asg -ScheduledActionName "myScheduledAction" -StartTime "2015-12-01T00:00:00Z" -DesiredCapacity 10 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[PutScheduledUpdateGroupAction](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。