Set-AzVMAccessExtension
將 VMAccess 擴充功能新增至虛擬機。
語法
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 擴充功能可用來設定暫時密碼，這應該會在登入計算機之後立即加以變更。 Windows 域控制器不支援此功能。
範例
範例 1：新增 VMAccess 擴充功能
Set-AzVMAccessExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4"此命令會在 ResourceGroup11 中為名為 VirtualMachine07 的虛擬機新增 VMAccess 擴充功能。 命令會指定 VMAccess 的名稱和類型處理程式版本。
範例 2
將 VMAccess 擴充功能新增至虛擬機。 （ 自動產生 ）
Set-AzVMAccessExtension -Credential <PSCredential> -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -TypeHandlerVersion '2.4' -VMName 'VirtualMachine07'參數
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Credential
將虛擬機的使用者名稱和密碼指定為 PSCredential 物件。
如果您輸入的名稱與 VM 上目前的本機系統管理員帳戶不同，VMAccess 擴充功能會新增具有該名稱的本機系統管理員帳戶，並將指定的密碼指派給該帳戶。 如果 VM 上的本機系統管理員帳戶存在，則會重設密碼，如果帳戶已停用，VMAccess 擴充功能會啟用它。
若要取得認證，請使用 Get-Credential Cmdlet。
如需詳細資訊，請輸入 Get-Help Get-Credential。
| 類型: | PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableAutoUpgradeMinorVersion
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ForceRerun
表示此 Cmdlet 會在虛擬機上強制重新執行相同的擴充功能組態，而不需卸載並重新安裝擴充功能。 值可以是與目前值不同的任何字串。 如果未變更 forceUpdateTag，處理程式仍會套用對公用或受保護設定的更新。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Location
指定虛擬機的位置。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定此 Cmdlet 新增的延伸模組名稱。
| 類型: | String |
| 別名: | ExtensionName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-NoWait
啟動作業，並在作業完成之前立即傳回。 若要判斷作業是否已順利完成，請使用一些其他機制。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ResourceGroupName
指定虛擬機的資源群組名稱。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-TypeHandlerVersion
指定要用於此虛擬機的擴充功能版本。 若要取得版本，請使用 PublisherName 參數的 Microsoft.Compute 值和 Type 參數的 VMAccessAgent 執行 Get-AzVMExtensionImage Cmdlet。 typeHandlerVersion 必須是 2.0 或更新版本，因為第 1 版已被取代。
| 類型: | String |
| 別名: | HandlerVersion, Version |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VMName
指定虛擬機的名稱。 這個 Cmdlet 會為此參數指定的虛擬機新增 VMAccess。
| 類型: | String |
| 別名: | ResourceName |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
