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

New-AzureServiceDiagnosticsExtensionConfig

为指定角色或所有角色生成诊断扩展的配置。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

New-AzureServiceDiagnosticsExtensionConfig
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [[-StorageAccountName] <String>]
   [[-StorageAccountKey] <String>]
   [[-StorageAccountEndpoint] <String>]
   [[-StorageContext] <AzureStorageContext>]
   [-DiagnosticsConfigurationPath] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceDiagnosticsExtensionConfig
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [[-StorageAccountKey] <String>]
   [[-StorageAccountEndpoint] <String>]
   [[-StorageContext] <AzureStorageContext>]
   [-DiagnosticsConfigurationPath] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceDiagnosticsExtensionConfig
   [[-StorageAccountName] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

说明

New-AzureServiceDiagnosticsExtensionConfig cmdlet 为指定角色或所有角色生成诊断扩展的配置。

示例

示例 1:为云服务中的所有角色创建Azure 诊断扩展

PS C:\> $WadConfig = New-AzureServiceDiagnosticExtensionConfig -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML

此命令为云服务中的所有角色创建Azure 诊断扩展。

示例 2:为角色创建Azure 诊断扩展

PS C:\> $WadConfig = New-AzureServiceDiagnosticExtensionConfig -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML -Role "WebRole1"

此命令为云服务中的角色 WebRole01 创建Azure 诊断扩展。

参数

-CertificateThumbprint

指定用于加密专用配置的证书指纹。 此证书必须已存在于证书存储中。 如果未指定证书,此 cmdlet 将创建证书。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DiagnosticsConfigurationPath

指定诊断配置路径。

类型:String
Position:7
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ExtensionId

指定扩展 ID。

类型:String
Position:8
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为:

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
别名:infa
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InformationVariable

指定信息变量。

类型:String
别名:iv
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Role

指定要为其指定诊断配置的角色的可选数组。 如果未指定诊断配置,则将其作为所有角色的默认配置应用。

类型:String[]
Position:0
默认值:None
必需:False
接受管道输入: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 存储上下文。

类型:AzureStorageContext
Position:6
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ThumbprintAlgorithm

指定指纹哈希算法,该算法与指纹一起使用以标识证书。 此参数是可选的,默认值为 sha1。

类型:String
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-X509Certificate

指定自动上传到云服务并用于加密扩展专用配置的 X.509 证书。

类型:X509Certificate2
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False