你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureVMDiagnosticsExtension
在虚拟机上配置Azure 诊断扩展。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。 创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。
语法
Set-AzureVMDiagnosticsExtension
[-DiagnosticsConfigurationPath] <String>
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <AzureStorageContext>]
[[-Version] <String>]
[-Disable]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMDiagnosticsExtension
[-DiagnosticsConfigurationPath] <String>
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <AzureStorageContext>]
[[-Version] <String>]
[-Disable]
[[-ReferenceName] <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] 说明
Set-AzureVMDiagnosticsExtension cmdlet 在虚拟机上配置Microsoft Azure 诊断扩展。
示例
示例 1：创建应用Azure 诊断扩展的虚拟机
PS C:\> $VM = New-AzureVMConfig -Name $VM -InstanceSize Small -ImageName $VMImage
PS C:\> $VM = Add-AzureProvisioningConfig -VM $VM -AdminUsername $Username -Password $Password -Windows
PS C:\> $VM = Set-AzureVMDiagnosticsExtension -DiagnosticsConfigurationPath $Config_Path -Version "1.*" -VM $VM -StorageContext $Storage_Context
PS C:\> New-AzureVM -Location $Location -ServiceName $Service_Name -VM $VM这些命令在虚拟机上启用Azure 诊断扩展。
示例 2：在现有虚拟机上启用Azure 诊断扩展
PS C:\> $VM = Get-AzureVM -ServiceName $Service_Name -Name $VM_Name
PS C:\> $VM_Update = Set-AzureVMDiagnosticsExtension -DiagnosticsConfigurationPath $Config_Path -Version "1.*" -VM $VM -StorageContext $Storage_Context
PS C:\> Update-AzureVM -ServiceName $Service_Name -Name $VM_Name -VM $VM_Update.VM第一个命令使用 Get-AzureVM cmdlet 获取虚拟机。
第二个命令使用 Set-AzureVMDiagnosticsExtension cmdlet 更新虚拟机配置以包含Azure 诊断扩展。
最后一个命令将更新的配置应用到虚拟机。
参数
-DiagnosticsConfigurationPath
指定诊断配置的路径。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Disable
指示此 cmdlet 禁用虚拟机上的诊断扩展。
| 类型: | SwitchParameter |
| Position: | 6 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InformationAction
指定此 cmdlet 如何响应信息事件。
此参数的可接受值为：
- 继续
- 忽略
- 询问
- SilentlyContinue
- 停止
- Suspend
| 类型: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
指定信息变量。
| 类型: | String |
| Aliases: | iv |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReferenceName
指定诊断扩展的引用名称。
| 类型: | String |
| Position: | 7 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountEndpoint
指定存储帐户终结点。
| 类型: | String |
| Position: | 3 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountKey
指定存储帐户密钥。
| 类型: | String |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountName
指定存储帐户名称。
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageContext
指定 Azure 存储上下文。
| 类型: | AzureStorageContext |
| Position: | 4 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Version
将扩展版本指定为字符串。
| 类型: | String |
| Position: | 5 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定持久性虚拟机对象。
| 类型: | IPersistentVM |
| Aliases: | InputObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |