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

New-AzureServiceExtensionConfig

  • 参考
模块:
Azure

为部署创建云服务扩展配置。

注意

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

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。

语法

New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [-ExtensionId] <String>
   [-ExtensionState] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

说明

New-AzureServiceExtensionConfig cmdlet 为部署创建云服务扩展配置。

示例

示例 1：创建扩展配置

PS C:\> New-AzureServiceExtensionConfig -ExtensionName 'RDP' -Version '1.0' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration $p1 -PrivateConfiguration $p2;

此命令指定扩展配置。

示例 2：为角色创建扩展配置

PS C:\> New-AzureServiceExtensionConfig -Role WebRole1 -ExtensionName 'RDP' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration $p1 -PrivateConfiguration $p2;

此命令指定角色 WebRole1 的扩展配置。

参数

-CertificateThumbprint

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

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

-ExtensionId

指定扩展的名称。

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

-ExtensionName

指定扩展的名称。

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

-ExtensionState

指定扩展的状态。 此参数的可接受值为：

  • 启用
  • 禁用
  • 卸载
类型:String
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-InformationAction

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

此参数的可接受值为：

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

-InformationVariable

指定信息变量。

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

-PrivateConfiguration

指定专用配置文本。

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

-Profile

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

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

-ProviderNamespace

指定扩展的提供程序命名空间。

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

-PublicConfiguration

指定公共配置文本。

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

-Role

指定要为其指定远程桌面配置的可选角色数组。 如果未指定远程桌面配置，则将其作为所有角色的默认配置应用。

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

-ThumbprintAlgorithm

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

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

-Version

指定扩展版本。

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

-X509Certificate

指定 x509 证书，该证书指定后将自动上传到云服务，并用于加密扩展专用配置。

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