New-AzureServiceADDomainExtensionConfig
產生雲端服務的 AD 網域延伸模組組態。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。
語法
New-AzureServiceADDomainExtensionConfig
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[-DomainName] <String>
[-Restart]
[[-Credential] <PSCredential>]
[[-UnjoinDomainCredential] <PSCredential>]
[[-Options] <JoinOptions>]
[[-OUPath] <String>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
New-AzureServiceADDomainExtensionConfig
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[-DomainName] <String>
[-Restart]
[[-Credential] <PSCredential>]
[[-UnjoinDomainCredential] <PSCredential>]
[-JoinOption] <UInt32>
[[-OUPath] <String>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
New-AzureServiceADDomainExtensionConfig
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[-WorkgroupName] <String>
[-Restart]
[[-Credential] <PSCredential>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
New-AzureServiceADDomainExtensionConfig
[[-Role] <String[]>]
[-CertificateThumbprint] <String>
[[-ThumbprintAlgorithm] <String>]
[-DomainName] <String>
[-Restart]
[[-Credential] <PSCredential>]
[[-UnjoinDomainCredential] <PSCredential>]
[[-Options] <JoinOptions>]
[[-OUPath] <String>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
New-AzureServiceADDomainExtensionConfig
[[-Role] <String[]>]
[-CertificateThumbprint] <String>
[[-ThumbprintAlgorithm] <String>]
[-DomainName] <String>
[-Restart]
[[-Credential] <PSCredential>]
[[-UnjoinDomainCredential] <PSCredential>]
[-JoinOption] <UInt32>
[[-OUPath] <String>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
New-AzureServiceADDomainExtensionConfig
[[-Role] <String[]>]
[-CertificateThumbprint] <String>
[[-ThumbprintAlgorithm] <String>]
[-WorkgroupName] <String>
[-Restart]
[[-Credential] <PSCredential>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
New-AzureServiceADDomainExtensionConfig Cmdlet 會產生雲端服務的 Active Directory (AD) 網域延伸模組組態。
範例
範例 1:指定 AD 網域組態
PS C:\> $ExtensionCfg = New-AzureServiceADDomainExtensionConfig -Role WorkerRole1 -DomainName $Domain -Credential $Cred -JoinOption 35;
PS C:\> New-AzureDeployment -ServiceName $CloudSvc -Slot "Production" -Package $Pkg -Configuration $Config -ExtensionConfiguration $ExtensionCfg;
此命令會產生AD網域擴充功能的組態。
參數
-CertificateThumbprint
指定要用來加密私人組態的憑證指紋。 此憑證必須已存在於證書存儲中。 如果您未指定憑證,此 Cmdlet 會建立憑證。
類型: | String |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Credential
指定要用來加入 AD 網域的認證。 認證包括使用者名稱和密碼。
類型: | PSCredential |
Position: | 5 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-DomainName
指定 AD 功能變數名稱。
類型: | String |
Position: | 3 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ExtensionId
指定延伸模組識別碼。
類型: | String |
Position: | 10 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為:
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
類型: | ActionPreference |
別名: | infa |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InformationVariable
指定資訊變數。
類型: | String |
別名: | iv |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-JoinOption
指定聯結選項列舉。
類型: | UInt32 |
Position: | 7 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Options
指定不帶正負號的整數聯結選項。
類型: | JoinOptions |
Position: | 7 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-OUPath
指定 AD 網域加入作業的組織單位 (OU) 路徑。
類型: | String |
Position: | 8 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設配置檔讀取。
類型: | AzureSMProfile |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Restart
指定如果聯結作業成功,是否要重新啟動計算機。
類型: | SwitchParameter |
Position: | 4 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Role
指定選擇性的角色陣列,以指定AD網域組態的遠端桌面組態。 如果您未指定此參數,AD 網域組態會套用為所有角色的預設組態。
類型: | String[] |
Position: | 0 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ThumbprintAlgorithm
指定指紋哈希演算法,此演算法會搭配指紋來識別憑證。 此參數是選擇性的,預設值為sha1。
類型: | String |
Position: | 2 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-UnjoinDomainCredential
指定要取消加入 AD 網域的認證(使用者名稱和密碼)。
類型: | PSCredential |
Position: | 6 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Version
指定擴充功能版本。
類型: | String |
Position: | 9 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-WorkgroupName
指定工作組名稱。
類型: | String |
Position: | 3 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-X509Certificate
指定自動上傳至雲端服務的 X.509 憑證,並用於加密擴充功能私人組態。
類型: | X509Certificate2 |
Position: | 1 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |