次の方法で共有

Set-AzVMAccessExtension

  • リファレンス
モジュール:
Az.Compute

仮想マシンに VMAccess 拡張機能を追加します。

構文

Set-AzVMAccessExtension
   [-Credential <PSCredential>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzVMAccessExtension コマンドレットは、仮想マシン アクセス (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

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

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

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableAutoUpgradeMinorVersion

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ForceRerun

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Location

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

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

型:String
Aliases:ExtensionName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-NoWait

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ResourceGroupName

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

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-TypeHandlerVersion

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

型:String
Aliases:HandlerVersion, Version
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VMName

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

型:String
Aliases:ResourceName
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

PSCredential

String

SwitchParameter

出力

PSAzureOperationResponse