共用方式為

New-AzureServiceExtensionConfig

  • 參考
模組:
Azure

建立部署的雲端服務擴充功能組態。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

語法

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>]

Description

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
  • 停止
  • 暫止
類型: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

指定延伸模組的提供者Namespace。

類型: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