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>]

説明

例

例 1: VMAccess 拡張機能を追加する

Set-AzVMAccessExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4"

例 2

Set-AzVMAccessExtension -Credential <PSCredential> -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -TypeHandlerVersion '2.4' -VMName 'VirtualMachine07'

パラメーター

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

パラメーター セット

-Credential

仮想マシンのユーザー名とパスワードを PSCredential オブジェクトとして指定します。 VM 上の現在のローカル管理者アカウントとは異なる名前を入力した場合、VMAccess 拡張機能はその名前のローカル管理者アカウントを追加し、指定したパスワードをそのアカウントに割り当てます。 VM にローカル管理者アカウントが存在する場合は、パスワードがリセットされ、アカウントが無効になっている場合は、VMAccess 拡張機能によって有効になります。 資格情報を取得するには、Get-Credential コマンドレットを使用します。 詳細については、「 Get-Help Get-Credential」と入力します。

パラメーターのプロパティ

パラメーター セット

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

パラメーターのプロパティ

パラメーター セット

-DisableAutoUpgradeMinorVersion

Set-AzVMAccessExtension コマンドレットは、仮想マシン アクセス (VMAccess) 仮想マシン VMAccess 拡張機能を仮想マシンに追加します。 VMAccess 拡張機能を使用して一時パスワードを設定できます。これは、マシンにログインした後すぐに変更する必要があります。 これは、Windows ドメイン コントローラーではサポートされていません。

パラメーターのプロパティ

パラメーター セット

-ForceRerun

このコマンドレットが、拡張機能をアンインストールして再インストールすることなく、仮想マシン上で同じ拡張機能構成を強制的に再実行することを示します。 値には、現在の値とは異なる任意の文字列を指定できます。 forceUpdateTag が変更されていない場合でも、ハンドラーによってパブリックまたは保護された設定の更新が適用されます。

パラメーターのプロパティ

パラメーター セット

-Location

仮想マシンの場所を指定します。

パラメーターのプロパティ

パラメーター セット

-Name

このコマンドレットが追加する拡張機能の名前を指定します。

パラメーターのプロパティ

パラメーター セット

-NoWait

操作を開始し、操作が完了する直前に戻ります。 操作が正常に完了したかどうかを判断するには、他のメカニズムを使用します。

パラメーターのプロパティ

パラメーター セット

-ResourceGroupName

仮想マシンのリソース グループの名前を指定します。

パラメーターのプロパティ

パラメーター セット

-TypeHandlerVersion

この仮想マシンに使用する拡張機能のバージョンを指定します。 バージョンを取得するには、 PublisherName パラメーターに Microsoft.Compute、 Type パラメーターに VMAccessAgent の値を指定して、Get-AzVMExtensionImage コマンドレットを実行します。 バージョン 1 は非推奨であるため、typeHandlerVersion は 2.0 以上である必要があります。

パラメーターのプロパティ

パラメーター セット

-VMName

仮想マシンの名前を指定します。 このコマンドレットは、このパラメーターが指定する仮想マシンの VMAccess を追加します。

パラメーターのプロパティ

パラメーター セット

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

PSCredential

String

SwitchParameter

出力

PSAzureOperationResponse

関連リンク

• Get-AzVMAccessExtension
• Remove-AzVMAccessExtension
• Set-AzVMExtension
• Get-AzVMExtensionImage