共用方式為

Stop-AzureVM

  • 參考
模組:
Azure

關閉 Azure 虛擬機。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 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>]

Description

Stop-AzureVM Cmdlet 會關閉虛擬機。

範例

範例 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
Position:3
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
類型:ActionPreference
別名:infa
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationVariable

指定資訊變數。

類型:String
別名:iv
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定要關閉的虛擬機名稱。

使用通配符以異步方式停止多部虛擬機。 使用通配符時，此 Cmdlet 會呼叫關機角色https://msdn.microsoft.com/en-us/library/azure/dn469421.aspx 作業 （https://msdn.microsoft.com/en-us/library/azure/dn469421.aspx），而不是關機角色https://msdn.microsoft.com/en-us/library/azure/jj157195.aspx 作業 （https://msdn.microsoft.com/en-us/library/azure/jj157195.aspx）。

類型:String[]
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ServiceName

指定要關閉之虛擬機的 Azure 服務名稱。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-StayProvisioned

指定此 Cmdlet 會保留虛擬機佈建。

類型:SwitchParameter
Position:2
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VM

指定要關閉之虛擬機的虛擬機物件。

類型:IPersistentVM[]
別名:InputObject
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False