你当前正在访问 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"此命令使用诊断配置文件启用诊断。 文件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
指示此 cmdlet 是否允许 Azure 来宾代理将扩展自动更新为较新的次要版本。
| 类型: | Boolean |
| Position: | 10 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DiagnosticsConfigurationPath
指定配置文件的路径。
| 类型: | String |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Location
指定虚拟机的位置。
| 类型: | String |
| Position: | 7 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
指定扩展的名称。
| 类型: | String |
| 别名: | ExtensionName |
| Position: | 8 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-NoWait
在操作完成之前立即启动操作并返回。 若要确定操作是否已成功完成，请使用一些其他机制。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ResourceGroupName
指定虚拟机资源组的名称。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-StorageAccountEndpoint
指定存储帐户终结点。
| 类型: | String |
| Position: | 5 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-StorageAccountKey
指定存储帐户密钥。
| 类型: | String |
| Position: | 4 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-StorageAccountName
指定存储帐户名。
| 类型: | String |
| Position: | 3 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-StorageContext
指定 Azure 存储上下文。
| 类型: | IStorageContext |
| Position: | 6 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-TypeHandlerVersion
指定要用于此虚拟机的扩展版本。 若要获取版本，请运行 Get-AzVMExtensionImage cmdlet，其中 publisherName 参数的值为 Microsoft.Compute，为 Type 参数运行 VMAccessAgent。
| 类型: | String |
| 别名: | HandlerVersion, Version |
| Position: | 9 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-VMName
指定运行此 cmdlet 的虚拟机的名称。
| 类型: | String |
| 别名: | ResourceName |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |