共用方式為


Set-AzConnectedMachineExtension

更新延伸模組的作業。

語法

UpdateExpanded (預設值)

Set-AzConnectedMachineExtension
    -MachineName <String>
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    [-SubscriptionId <String>]
    [-AutoUpgradeMinorVersion]
    [-EnableAutomaticUpgrade]
    [-ExtensionType <String>]
    [-ForceRerun <String>]
    [-InstanceViewName <String>]
    [-InstanceViewType <String>]
    [-InstanceViewTypeHandlerVersion <String>]
    [-ProtectedSetting <Hashtable>]
    [-Publisher <String>]
    [-Setting <Hashtable>]
    [-StatusCode <String>]
    [-StatusDisplayStatus <String>]
    [-StatusLevel <String>]
    [-StatusMessage <String>]
    [-StatusTime <DateTime>]
    [-Tag <Hashtable>]
    [-TypeHandlerVersion <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Update

Set-AzConnectedMachineExtension
    -MachineName <String>
    -Name <String>
    -ResourceGroupName <String>
    -ExtensionParameter <IMachineExtension>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonFilePath

Set-AzConnectedMachineExtension
    -MachineName <String>
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonString

Set-AzConnectedMachineExtension
    -MachineName <String>
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

更新延伸模組的作業。

範例

範例 1:在電腦上設定延伸模組

$Settings = @{ "commandToExecute" = "powershell.exe -c Get-Process" }
Set-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName win-eastus1 -Location eastus -Publisher "Microsoft.Compute" -TypeHandlerVersion 1.10 -Settings $Settings -ExtensionType CustomScriptExtension
Name   Location ProvisioningState
----   -------- -----------------
custom eastus   Succeeded

在電腦上設定延伸。

範例 2:使用透過管線指定的延伸模組參數設定延伸模組

$otherExtension = Get-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName other
$otherExtension | Set-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName important
Name   Location ProvisioningState
----   -------- -----------------
custom eastus   Succeeded

這會使用透過管線傳入的物件所提供的延伸模組參數來設定延伸模組。 如果您想獲取一台機器的參數並將其應用到另一台機器,這非常有用。

參數

-AsJob

以作業身分執行命令

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AutoUpgradeMinorVersion

指出如果部署期間有新的次要版本,擴充功能是否應該使用較新的次要版本。 不過,部署之後,除非重新部署,否則擴充功能不會升級次要版本,即使此屬性設定為 true 也一定會升級。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet,請使用 SubscriptionId 參數。

參數屬性

類型:PSObject
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzureRMContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EnableAutomaticUpgrade

指出如果有較新版本可用,平臺是否應該自動升級延伸模組。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExtensionParameter

描述機器延伸。

參數屬性

類型:IMachineExtension
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Update
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExtensionType

指定延伸模組的類型;例如“CustomScriptExtension”。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ForceRerun

即使延伸模組組態尚未變更,延伸模組處理程式也應該強制更新。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InstanceViewName

計算機延伸模組名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InstanceViewType

指定延伸模組的類型;例如“CustomScriptExtension”。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InstanceViewTypeHandlerVersion

指定文稿處理程式的版本。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-JsonFilePath

提供給更新作業的 Json 檔案路徑

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateViaJsonFilePath
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-JsonString

提供給更新作業的 Json 字串

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateViaJsonString
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Location

資源所在的地理位置

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MachineName

應該建立或更新擴充功能的計算機名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

計算機擴充功能的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-NoWait

以異步方式執行命令

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ProtectedSetting

延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。

參數屬性

類型:Hashtable
預設值:None
支援萬用字元:False
不要顯示:False
別名:受保護設定

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Publisher

擴充處理程序發行者的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceGroupName

資源群組的名稱。 名稱不區分大小寫。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Setting

擴充功能的 Json 格式化公用設定。

參數屬性

類型:Hashtable
預設值:None
支援萬用字元:False
不要顯示:False
別名:設定

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StatusCode

狀態代碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StatusDisplayStatus

狀態的簡短可當地語系化標籤。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StatusLevel

層級程序代碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StatusMessage

詳細的狀態消息,包括警示和錯誤訊息。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StatusTime

狀態的時間。

參數屬性

類型:DateTime
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SubscriptionId

目標訂用帳戶的標識碼。

參數屬性

類型:String
預設值:(Get-AzContext).Subscription.Id
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Tag

資源標籤。

參數屬性

類型:Hashtable
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TypeHandlerVersion

指定文稿處理程式的版本。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

UpdateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

IMachineExtension

輸出

IMachineExtension