次の方法で共有


Set-AzVMDiagnosticsExtension

仮想マシンで Azure Diagnostics 拡張機能を構成します。

構文

Set-AzVMDiagnosticsExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-DiagnosticsConfigurationPath] <String>
   [[-StorageAccountName] <String>]
   [[-StorageAccountKey] <String>]
   [[-StorageAccountEndpoint] <String>]
   [[-StorageContext] <IStorageContext>]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-TypeHandlerVersion] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Set-AzVMDiagnosticsExtension コマンドレットは、仮想マシンで Azure Diagnostics 拡張機能を構成します。

例 1: 診断構成ファイルで指定されたストレージ アカウントを使用して診断を有効にする

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"

このコマンドでは、診断構成ファイルを使用して診断を有効にします。 ファイル diagnostics_publicconfig.xmlには、診断データの送信先となるストレージ アカウントの名前など、診断拡張機能のパブリック XML 構成が含まれています。 診断ストレージ アカウントは、仮想マシンと同じサブスクリプションに存在する必要があります。

例 2: ストレージ アカウント名を使用して診断を有効にする

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"

このコマンドでは、ストレージ アカウント名を使用して診断を有効にします。 診断構成でストレージ アカウント名が指定されていない場合、または構成ファイルで指定された診断ストレージ アカウント名をオーバーライドする場合は、 StorageAccountName パラメーターを使用します。 診断ストレージ アカウントは、仮想マシンと同じサブスクリプションに存在する必要があります。

例 3: ストレージ アカウント名とキーを使用して診断を有効にする

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml" -StorageAccountName "MyStorageAccount" -StorageAccountKey $storage_key

このコマンドでは、ストレージ アカウント名とキーを使用して診断を有効にします。 診断ストレージ アカウントが仮想マシンとは異なるサブスクリプションにある場合は、名前とキーを明示的に指定して、そのストレージ アカウントへの診断データの送信を有効にします。

パラメーター

-AutoUpgradeMinorVersion

このコマンドレットを使用して、Azure ゲスト エージェントが拡張機能を新しいマイナー バージョンに自動的に更新できるかどうかを示します。

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

-DefaultProfile

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

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

-DiagnosticsConfigurationPath

構成ファイルのパスを指定します。

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

-Location

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

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

-Name

拡張機能の名前を指定します。

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

-NoWait

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

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

-ResourceGroupName

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

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

-StorageAccountEndpoint

ストレージ アカウント エンドポイントを指定します。

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

-StorageAccountKey

ストレージ アカウント キーを指定します。

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

-StorageAccountName

ストレージ アカウント名を指定します。

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

-StorageContext

Azure ストレージ コンテキストを指定します。

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

-TypeHandlerVersion

この仮想マシンに使用する拡張機能のバージョンを指定します。 バージョンを取得するには、Get-AzVMExtensionImage コマンドレットを実行し、 PublisherName パラメーターには Microsoft.Compute、 Type パラメーターには VMAccessAgent の値を指定します。

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

-VMName

このコマンドレットが動作する仮想マシンの名前を指定します。

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

入力

String

IStorageContext

Boolean

出力

PSAzureOperationResponse