共用方式為


Set-AzureVMBGInfoExtension

設定虛擬機的 BGInfo 擴充功能。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。

語法

Set-AzureVMBGInfoExtension
   [-Disable]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMBGInfoExtension
   [-Uninstall]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Set-AzureVMBGInfoExtension Cmdlet 會設定虛擬機的 BGInfo 擴充功能。

範例

範例 1:設定虛擬機的 BGInfo 擴充功能

PS C:\> Set-AzureVMBGInfoExtension -VM $VM

此命令會將指定虛擬機的 BGInfo 擴充功能設定為儲存在變數$VM中。

參數

-Disable

表示此 Cmdlet 會停用擴充功能狀態。

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

-InformationAction

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

此參數可接受的值為:

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

-InformationVariable

指定資訊變數。

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

-Profile

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

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

-ReferenceName

指定 BGInfo 延伸模組的參考名稱。

此參數是使用者定義字串,可用來參考延伸模組。 第一次將擴充功能新增至虛擬機時,會指定此擴充功能。 您可以在更新延伸模組時指定先前使用的參考名稱。

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

-Uninstall

指出此 Cmdlet 會卸載 BGInfo 擴充功能。

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

-Version

指定 BGInfo 延伸模組的版本。

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

-VM

指定持續性虛擬機物件。

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