Stop-AzureVM
Azure 仮想マシンをシャットダウンします。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
Stop-AzureVM
[-Name] <String[]>
[-StayProvisioned]
[-Force]
[-ServiceName] <String>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Stop-AzureVM
-VM <IPersistentVM[]>
[-StayProvisioned]
[-Force]
[-ServiceName] <String>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
説明
Stop-AzureVM コマンドレットは、仮想マシンをシャットダウンします。
例
例 1: 仮想マシンをシャットダウンする
PS C:\> Stop-AzureVM -ServiceName "ContosoService01" -Name "MyVM"
このコマンドは、指定されたサービスに含まれる仮想マシンをシャットダウンします。
例 2: 仮想マシン オブジェクトを使用して仮想マシンをシャットダウンする
PS C:\> Get-AzureVM -ServiceName "ContosoService01" -Name "MyVM" | Stop-AzureVM
このコマンドは、Get-AzureVM から返される仮想マシン オブジェクトを使用して、指定されたサービスに含まれる仮想マシンをシャットダウンします。
例 3: VM をシャットダウンし、VM をプロビジョニングしたままにする
PS C:\> Stop-AzureVM -ServiceName "ContosoService01" -Name "MyVM" -StayProvisioned
このコマンドは、指定されたサービスに含まれる仮想マシンをシャットダウンし、プロビジョニングされた状態を維持します。
例 4: VM をシャットダウンし、デプロイ内の最後の VM の割り当て解除を許可する
PS C:\> Stop-AzureVM -ServiceName "ContosoService01" -Name "MyVM" -Force
このコマンドは、指定されたサービスに含まれる仮想マシンをシャットダウンし、デプロイ内の最後の仮想マシンの割り当てを解除できるようにします。
例 5: 複数の VM をシャットダウンする
PS C:\> Stop-AzureVM -ServiceName "PSTestService" -Name "*" -Force
このコマンドは、指定されたサービスに含まれる複数の仮想マシンをシャットダウンします。
パラメーター
-Force
デプロイ内の最後の仮想マシンの割り当て解除を許可するかどうかを指定します。
Type: | SwitchParameter |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
情報変数を指定します。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
シャットダウンする仮想マシンの名前を指定します。
ワイルドカード文字を使用して、複数の仮想マシンを非同期的に停止します。 ワイルドカード文字を使用すると、このコマンドレットはシャットダウン ロール操作 (https://msdn.microsoft.com/en-us/library/azure/dn469421.aspx) ではなく、Shutdown Roleshttps://msdn.microsoft.com/en-us/library/azure/dn469421.aspxhttps://msdn.microsoft.com/en-us/library/azure/jj157195.aspx 操作 (https://msdn.microsoft.com/en-us/library/azure/jj157195.aspx) を呼び出します。
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceName
シャットダウンする仮想マシンを含む Azure サービスの名前を指定します。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StayProvisioned
このコマンドレットが仮想マシンをプロビジョニングしたままにすることを指定します。
Type: | SwitchParameter |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
シャットダウンする仮想マシンを識別する仮想マシン オブジェクトを指定します。
Type: | IPersistentVM[] |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |