你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureServiceADDomainExtension
为云服务启用 AD 域扩展。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
Set-AzureServiceADDomainExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-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>] Set-AzureServiceADDomainExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-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>] Set-AzureServiceADDomainExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[-WorkgroupName] <String>
[-Restart]
[[-Credential] <PSCredential>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureServiceADDomainExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-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>] Set-AzureServiceADDomainExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-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>] Set-AzureServiceADDomainExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[-CertificateThumbprint] <String>
[[-ThumbprintAlgorithm] <String>]
[-WorkgroupName] <String>
[-Restart]
[[-Credential] <PSCredential>]
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] 说明
Set-AzureServiceADDomainExtension cmdlet 为云服务启用 AD（Active Directory）域扩展。
示例
1：
参数
-CertificateThumbprint
指定用于加密专用配置的证书指纹。 此证书必须已存在于证书存储中。 如果未指定证书，此 cmdlet 将创建证书。
| 类型: | String |
| Position: | 3 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Credential
指定要加入 AD 域的凭据。 凭据包括用户名和密码。
| 类型: | PSCredential |
| Position: | 7 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-DomainName
指定 AD 域名。
| 类型: | String |
| Position: | 5 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ExtensionId
指定扩展 ID。
| 类型: | String |
| Position: | 13 |
| 默认值: | 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 |
-JoinOption
指定联接选项枚举。
| 类型: | UInt32 |
| Position: | 10 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Options
指定无符号整数联接选项。
| 类型: | JoinOptions |
| Position: | 9 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-OUPath
指定 AD 域加入操作的组织单位（OU）路径。
| 类型: | String |
| Position: | 11 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Restart
指定如果联接操作成功，是否重启计算机。
| 类型: | SwitchParameter |
| Position: | 6 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Role
指定要为其指定远程桌面配置的角色的可选数组。 如果未指定 AD 域配置，则将其作为所有角色的默认配置应用。
| 类型: | String[] |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ServiceName
指定云服务名称。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Slot
指定要修改的部署环境。 此参数的可接受值为：生产或暂存。
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ThumbprintAlgorithm
指定指纹哈希算法，该算法与指纹一起使用以标识证书。 此参数是可选的，默认值为 sha1。
| 类型: | String |
| Position: | 4 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-UnjoinDomainCredential
指定要取消加入 AD 域的凭据（用户名和密码）。
| 类型: | PSCredential |
| Position: | 8 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Version
指定扩展版本。
| 类型: | String |
| Position: | 12 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-WorkgroupName
指定工作组名称。
| 类型: | String |
| Position: | 5 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-X509Certificate
指定 x509 证书，该证书指定后将自动上传到云服务，并用于加密扩展专用配置。
| 类型: | X509Certificate2 |
| Position: | 3 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |