Set-AzVMBginfoExtension

參考

模組:: Az.Compute

將 BGInfo 擴充功能新增至虛擬機。

Syntax

Set-AzVMBginfoExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzVMBGInfoExtension Cmdlet 會將 BGInfo 擴充功能新增至虛擬機。

範例

範例 1：新增虛擬機的 BGInfo 擴充功能

Set-AzVMBgInfoExtension -ResourceGroupName "ContosoRG" -VMName "ContosoVM" -Name "ExtensionName" -TypeHandlerVersion "2.1" -Location "West Europe"

此命令會將 BGInfo 擴充功能新增至名為 ContosoVM 的虛擬機。命令會指定虛擬機的資源群組和位置。命令會指定延伸模組的名稱和版本。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableAutoUpgradeMinorVersion

指出此 Cmdlet 會防止 Azure 客體代理程式將擴充功能自動更新為較新的次要版本。根據預設，此 Cmdlet 可讓客體代理程式更新擴充功能。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ForceRerun

指定應該使用相同的公用或受保護的設定再次執行延伸模組。值可以是與目前值不同的任何字串。如果未變更 forceUpdateTag，處理程式仍會套用對公用或受保護設定的更新。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

指定虛擬機的位置。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

指定此 Cmdlet 新增至虛擬機的 BGInfo 擴充功能名稱。

Type:	String
Aliases:	ExtensionName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoWait

啟動作業，並在作業完成之前立即傳回。若要判斷作業是否已順利完成，請使用一些其他機制。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

指定此 Cmdlet 新增擴充功能之虛擬機的資源群組名稱。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TypeHandlerVersion

指定此 Cmdlet 新增至虛擬機的擴充功能版本。

Type:	String
Aliases:	HandlerVersion, Version
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

指定此 Cmdlet 新增 BGInfo 擴充功能的虛擬機名稱。

Type:	String
Aliases:	ResourceName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

String

SwitchParameter

輸出

PSAzureOperationResponse