Set-AzVMBginfoExtension
將 BGInfo 擴充功能新增至虛擬機。
語法
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 之前，提示您進行確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableAutoUpgradeMinorVersion
指出此 Cmdlet 會防止 Azure 客體代理程式將擴充功能自動更新為較新的次要版本。 根據預設，此 Cmdlet 可讓客體代理程式更新擴充功能。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ForceRerun
指定應該使用相同的公用或受保護的設定再次執行延伸模組。 值可以是與目前值不同的任何字串。 如果未變更 forceUpdateTag，處理程式仍會套用對公用或受保護設定的更新。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Location
指定虛擬機的位置。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定此 Cmdlet 新增至虛擬機的 BGInfo 擴充功能名稱。
| 類型: | String |
| 別名: | ExtensionName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-NoWait
啟動作業，並在作業完成之前立即傳回。 若要判斷作業是否已順利完成，請使用一些其他機制。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ResourceGroupName
指定此 Cmdlet 新增擴充功能之虛擬機的資源群組名稱。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-TypeHandlerVersion
指定此 Cmdlet 新增至虛擬機的擴充功能版本。
| 類型: | String |
| 別名: | HandlerVersion, Version |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VMName
指定此 Cmdlet 新增 BGInfo 擴充功能的虛擬機名稱。
| 類型: | String |
| 別名: | ResourceName |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
