Set-AzVMExtension
更新擴充功能屬性，或將擴充功能新增至虛擬機。
語法
Set-AzVMExtension
-Publisher <String>
-ExtensionType <String>
[-Settings <Hashtable>]
[-ProtectedSettings <Hashtable>]
[-EnableAutomaticUpgrade <Boolean>]
[-AsJob]
[-ResourceGroupName] <String>
[-VMName] <String>
-Name <String>
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzVMExtension
-Publisher <String>
-ExtensionType <String>
[-SettingString <String>]
[-ProtectedSettingString <String>]
[-EnableAutomaticUpgrade <Boolean>]
[-AsJob]
[-ResourceGroupName] <String>
[-VMName] <String>
-Name <String>
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-AzVMExtension Cmdlet 會更新現有虛擬機擴充功能的屬性，或將擴充功能新增至虛擬機。
範例
範例 1：使用哈希表修改設定
$Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
$ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};
Set-AzVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "ContosoTest" -Publisher "Contoso.Compute" -ExtensionType "CustomScriptExtension" -TypeHandlerVersion "1.1" -Settings $Settings -ProtectedSettings $ProtectedSettings;前兩個命令會使用標準 Windows PowerShell 語法來建立哈希表，然後將這些哈希表儲存在$Settings和$ProtectedSettings變數中。
如需詳細資訊，請輸入 Get-Help about_Hash_Tables。
第二個命令包含先前建立並儲存在變數中的兩個值。
最後一個命令會根據$Settings和$ProtectedSettings的內容，修改 ResourceGroup11 中名為 VirtualMachine22 的虛擬機擴充功能。
命令會指定包含發行者和延伸模組類型的其他必要資訊。
範例 2：使用字串修改設定
$SettingsString = '{"fileUris":[],"commandToExecute":""}';
$ProtectedSettingsString = '{"storageAccountName":"' + $stoname + '","storageAccountKey":"' + $stokey + '"}';
Set-AzVMExtension -ResourceGroupName "ResourceGroup11" -Location "West US" -VMName "VirtualMachine22" -Name "CustomScriptExtension" -Publisher "Contoso.Compute" -ExtensionType "CustomScriptExtension" -TypeHandlerVersion "1.1" -SettingString $SettingsString -ProtectedSettingString $ProtectedSettingsString ;前兩個命令會建立包含設定的字串，然後將它們儲存在$SettingsString和$ProtectedSettingsString變數中。 最後一個命令會根據$SettingsString和$ProtectedSettingsString的內容，修改 ResourceGroup11 中名為 VirtualMachine22 的虛擬機擴充功能。 命令會指定包含發行者和延伸模組類型的其他必要資訊。
參數
-AsJob
在背景執行 Cmdlet
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-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 |
-EnableAutomaticUpgrade
指出如果有較新版本的延伸模組可用，平臺是否應該自動升級延伸模組。
| 類型: | Nullable<T>[Boolean] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ExtensionType
指定延伸模組類型。
| 類型: | String |
| 別名: | Type |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ForceRerun
表示此 Cmdlet 會在虛擬機上強制重新執行相同的擴充功能組態，而不需卸載並重新安裝擴充功能。 值可以是與目前值不同的任何字串。 如果未變更 forceUpdateTag，處理程式仍會套用對公用或受保護設定的更新。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Location
指定虛擬機的位置。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定延伸模組的名稱。
| 類型: | String |
| 別名: | ExtensionName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-NoWait
啟動作業，並在作業完成之前立即傳回。 若要判斷作業是否已順利完成，請使用一些其他機制。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ProtectedSettings
指定延伸模組的私人組態，做為哈希表。 此 Cmdlet 會加密私人組態。
| 類型: | Hashtable |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ProtectedSettingString
將擴充功能的私人組態指定為字串。 此 Cmdlet 會加密私人組態。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Publisher
指定擴充功能發行者的名稱。 發行者會在發行者註冊擴充功能時提供名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceGroupName
指定虛擬機的資源群組名稱。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Settings
指定延伸模組的公用組態，做為哈希表。 此 Cmdlet 不會加密公用組態。
| 類型: | Hashtable |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SettingString
將延伸模組的公用組態指定為字串。 此 Cmdlet 不會加密公用組態。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-TypeHandlerVersion
指定要用於此虛擬機的擴充功能版本。
| 類型: | String |
| 別名: | HandlerVersion, Version |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VMName
指定虛擬機的名稱。 這個 Cmdlet 會修改此參數所指定之虛擬機的擴充功能。
| 類型: | String |
| 別名: | ResourceName |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |