New-AzureServiceExtensionConfig
建立部署的雲端服務擴充功能組態。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet,請參閱 Az PowerShell 模組 。
Syntax
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 會建立憑證。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionId
指定延伸模組的名稱。
Type: | String |
Position: | 8 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionName
指定延伸模組的名稱。
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionState
指定延伸模組的狀態。 此參數可接受的值為:
- 啟用
- 停用
- 解除安裝
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為:
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
指定資訊變數。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateConfiguration
指定私人組態文字。
Type: | String |
Position: | 6 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設設定檔讀取。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProviderNamespace
指定延伸模組的提供者命名空間。
Type: | String |
Position: | 4 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicConfiguration
指定公用組態文字。
Type: | String |
Position: | 5 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Role
指定要為其指定遠端桌面組態的選擇性角色陣列。 如果未指定遠端桌面組態,則會套用為所有角色的預設組態。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ThumbprintAlgorithm
指定指紋雜湊演算法,此演算法會與指紋搭配使用,以識別憑證。 此參數是選擇性的,預設值為 sha1。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
指定擴充功能版本。
Type: | String |
Position: | 7 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-X509Certificate
指定 x509 憑證,該憑證會在指定時自動上傳至雲端服務,並用於加密擴充功能私人組態。
Type: | X509Certificate2 |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |