Share via

Set-AzVMAccessExtension

  • 參考
模組:
Az.Compute

將 VMAccess 擴充功能新增至虛擬機。

Syntax

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 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

將虛擬機的使用者名稱和密碼指定為 PSCredential 物件。 如果您輸入的名稱與 VM 上目前的本機系統管理員帳戶不同，VMAccess 擴充功能會新增具有該名稱的本機系統管理員帳戶，並將指定的密碼指派給該帳戶。 如果 VM 上的本機系統管理員帳戶存在，則會重設密碼，如果帳戶已停用，VMAccess 擴充功能會啟用它。 若要取得認證，請使用 Get-Credential Cmdlet。 如需詳細資訊，請輸入 Get-Help Get-Credential。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableAutoUpgradeMinorVersion

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ForceRerun

表示此 Cmdlet 會在虛擬機上強制重新執行相同的擴充功能組態，而不需卸載並重新安裝擴充功能。 值可以是與目前值不同的任何字串。 如果未變更 forceUpdateTag，處理程式仍會套用對公用或受保護設定的更新。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

指定虛擬機的位置。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定此 Cmdlet 新增的延伸模組名稱。

Type:String
Aliases:ExtensionName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoWait

啟動作業，並在作業完成之前立即傳回。 若要判斷作業是否已順利完成，請使用一些其他機制。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

指定虛擬機的資源群組名稱。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

指定要用於此虛擬機的擴充功能版本。 若要取得版本，請使用 PublisherName 參數的 Microsoft.Compute 值和 Type 參數的 VMAccessAgent 執行 Get-AzVMExtensionImage Cmdlet。 typeHandlerVersion 必須是 2.0 或更新版本，因為第 1 版已被取代。

Type:String
Aliases:HandlerVersion, Version
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

指定虛擬機的名稱。 這個 Cmdlet 會為此參數指定的虛擬機新增 VMAccess。

Type:String
Aliases:ResourceName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

PSCredential

String

SwitchParameter

輸出

PSAzureOperationResponse