你当前正在访问 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 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。

语法

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
Accept pipeline input:	True
Accept wildcard characters:	False

-Credential

指定要用于加入 AD 域的凭据。 凭据包括用户名和密码。

类型:	PSCredential
Position:	5
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DomainName

指定 AD 域名。

类型:	String
Position:	3
默认值:	None
必需:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ExtensionId

指定扩展 ID。

类型:	String
Position:	10
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

• 继续
• 忽略
• 询问
• SilentlyContinue
• 停止
• Suspend

类型:	ActionPreference
Aliases:	infa
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

指定信息变量。

类型:	String
Aliases:	iv
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JoinOption

指定联接选项枚举。

类型:	UInt32
Position:	7
默认值:	None
必需:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Options

指定无符号整数联接选项。

类型:	JoinOptions
Position:	7
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-OUPath

指定 AD 域加入操作的组织单位（OU）路径。

类型:	String
Position:	8
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

类型:	AzureSMProfile
Position:	Named
默认值:	None
必需:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Restart

指定如果联接操作成功，是否重启计算机。

类型:	SwitchParameter
Position:	4
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Role

指定可选角色数组，以指定 AD 域配置的远程桌面配置。 如果未指定此参数，AD 域配置将作为所有角色的默认配置应用。

类型:	String[]
Position:	0
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ThumbprintAlgorithm

指定指纹哈希算法，该算法与指纹一起使用以标识证书。 此参数是可选的，默认值为 sha1。

类型:	String
Position:	2
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UnjoinDomainCredential

指定要取消加入 AD 域的凭据（用户名和密码）。

类型:	PSCredential
Position:	6
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Version

指定扩展版本。

类型:	String
Position:	9
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WorkgroupName

指定工作组名称。

类型:	String
Position:	3
默认值:	None
必需:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-X509Certificate

指定自动上传到云服务并用于加密扩展专用配置的 X.509 证书。

类型:	X509Certificate2
Position:	1
默认值:	None
必需:	False
Accept pipeline input:	True
Accept wildcard characters:	False

相关链接

• Get-AzureServiceADDomainExtension
• Set-AzureServiceADDomainExtension