次の方法で共有

Stop-AzureVM

  • リファレンス
モジュール:
Azure

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
  • Stop
  • [中断]
型: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