Set-AzVMDiagnosticsExtension

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

構文

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 診断 拡張機能を構成します。

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

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

このコマンドでは、診断構成ファイルを使用して診断を有効にします。 ファイル 診断_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
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

-DiagnosticsConfigurationPath

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

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

-Location

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

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

-Name

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

Type:String
Aliases:ExtensionName
Position:8
Default value:None
Required:False
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

-StorageAccountEndpoint

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

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

-StorageAccountKey

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

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

-StorageAccountName

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

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

-StorageContext

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

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

-TypeHandlerVersion

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

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

-VMName

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

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

入力

String

IStorageContext

Boolean

出力

PSAzureOperationResponse