Stop-AzureVM
Azure 仮想マシンをシャットダウンします。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される 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
デプロイ内の最後の仮想マシンの割り当て解除を許可するかどうかを指定します。
型: | SwitchParameter |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- 阻止
- [中断]
型: | ActionPreference |
Aliases: | infa |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
型: | String |
Aliases: | iv |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | 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) を呼び出します。
型: | String[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServiceName
シャットダウンする仮想マシンを含む Azure サービスの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StayProvisioned
このコマンドレットが仮想マシンをプロビジョニングしたままにすることを指定します。
型: | SwitchParameter |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VM
シャットダウンする仮想マシンを識別する仮想マシン オブジェクトを指定します。
型: | IPersistentVM[] |
Aliases: | InputObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |