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

New-AzureServiceADDomainExtensionConfig

模块:

Azure

为云服务生成 AD 域扩展的配置。

注意

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

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (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>]

说明

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

指定扩展 ID。

类型:	String
Position:	10
默认值:	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:	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

相关链接

• Get-AzureServiceADDomainExtension
• Set-AzureServiceADDomainExtension