你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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 cmdlet 在虚拟机上配置 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"

此命令使用存储帐户名称启用诊断。 如果诊断配置未指定存储帐户名称,或者想要替代配置文件中指定的诊断存储帐户名称,请使用 存储AccountName 参数。 诊断存储帐户必须与虚拟机位于同一订阅中。

示例 3:使用存储帐户名称和密钥启用诊断

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

此命令使用存储帐户名称和密钥来启用诊断。 如果诊断存储帐户与虚拟机位于不同的订阅中,则通过显式指定其名称和密钥,启用向该存储帐户发送诊断数据。

参数

-AutoUpgradeMinorVersion

指示此 cmdlet 是否允许 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 参数的值和 Type 参数的 VMAccessAgent 的值运行 Get-AzVMExtensionImage cmdlet。

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

-VMName

指定运行此 cmdlet 的虚拟机的名称。

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

输入

String

IStorageContext

Boolean

输出

PSAzureOperationResponse