Set-AzVMDiagnosticsExtension

リファレンス

モジュール:: Az.Compute

仮想マシンで 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 ゲストエージェントが拡張機能を新しいマイナーバージョンに自動的に更新できるかどうかを示します。

Type:	Boolean
Position:	10
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

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

-DiagnosticsConfigurationPath

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

Type:	String
Position:	2
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

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

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

-Name

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

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

-NoWait

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

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

-ResourceGroupName

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

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

-StorageAccountEndpoint

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

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

-StorageAccountKey

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

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

-StorageAccountName

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

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

-StorageContext

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

Type:	IStorageContext
Position:	6
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-TypeHandlerVersion

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