Set-AzVMAccessExtension
語法
Default (預設值)
Set-AzVMAccessExtension
[-Credential <PSCredential>]
[-ResourceGroupName] <String>
[-VMName] <String>
-Name <String>
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzVMAccessExtension Cmdlet 會將虛擬機器存取 （VMAccess） 虛擬機器 VMAccess 延伸模組新增至虛擬機器。 VMAccess Extension 可用於設置臨時密碼，應在登錄計算機後立即更改。 Windows 網域控制站不支援此功能。
範例
範例 1：新增 VMAccess 延伸模組
Set-AzVMAccessExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4"
此命令會為 ResourceGroup11 中名為 VirtualMachine07 的虛擬機器新增 VMAccess 延伸模組。
此命令會指定 VMAccess 的名稱和類型處理常式版本。
範例 2
將 VMAccess 延伸模組新增至虛擬機器。 (autogenerated)
Set-AzVMAccessExtension -Credential <PSCredential> -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -TypeHandlerVersion '2.4' -VMName 'VirtualMachine07'
參數
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
將虛擬機器的使用者名稱和密碼指定為 PSCredential 物件。
如果您輸入的名稱與 VM 上目前的本機系統管理員帳戶不同，VMAccess 延伸模組會新增具有該名稱的本機系統管理員帳戶，並將您指定的密碼指派給該帳戶。 如果您的 VM 上存在本機系統管理員帳戶，它會重設密碼，如果帳戶已停用，VMAccess 延伸模組會啟用它。
若要取得認證，請使用 Get-Credential Cmdlet。
如需詳細資訊，請鍵入 Get-Help Get-Credential。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisableAutoUpgradeMinorVersion
Set-AzVMAccessExtension Cmdlet 會將虛擬機器存取 （VMAccess） 虛擬機器 VMAccess 延伸模組新增至虛擬機器。 VMAccess Extension 可用於設置臨時密碼，應在登錄計算機後立即更改。 Windows 網域控制站不支援此功能。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ForceRerun
表示此 Cmdlet 會強制在虛擬機器上重新執行相同的延伸模組設定，而不解除安裝並重新安裝延伸模組。
值可以是與目前值不同的任何字串。
如果未變更 forceUpdateTag，處理常式仍會套用公用或受保護設定的更新。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Location
指定虛擬機器的位置。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
指定此 Cmdlet 新增的延伸模組名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ExtensionName |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-NoWait
在作業完成之前啟動作業並立即傳回。 為了確定操作是否已成功完成，請使用其他一些機制。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResourceGroupName
指定虛擬機器資源群組的名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-TypeHandlerVersion
指定要用於此虛擬機器的延伸模組版本。
若要取得版本，請執行 Get-AzVMExtensionImage Cmdlet，PublisherName 參數的值為 Microsoft.Compute， 類型參數的 值為 VMAccessAgent。 typeHandlerVersion 必須是 2.0 或更高版本，因為版本 1 已被取代。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 處理常式版本, 版本 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-VMName
指定虛擬機器的名稱。
此 Cmdlet 會針對此參數指定的虛擬機器新增 VMAccess。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 資源名稱 |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。
指令未執行。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
