New-AzureServiceADDomainExtensionConfig
Genera la configuración de la extensión de dominio de AD para los servicios en la nube.
Nota:
Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.
El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.
Sintaxis
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
El cmdlet New-AzureServiceADDomainExtensionConfig genera la configuración de la extensión de dominio de Active Directory (AD) para los servicios en la nube.
Ejemplos
Ejemplo 1: Especificar una configuración de dominio de 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;Este comando genera una configuración para la extensión de dominio de AD.
Parámetros
-CertificateThumbprint
Especifica una huella digital de certificado que se va a usar para cifrar la configuración privada. Este certificado ya debe existir en el almacén de certificados. Si no especifica un certificado, este cmdlet crea un certificado.
| Tipo: | String |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Credential
Especifica las credenciales que se usarán para unirse al dominio de AD. Las credenciales incluyen un nombre de usuario y una contraseña.
| Tipo: | PSCredential |
| Posición: | 5 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-DomainName
Especifica el nombre de dominio de AD.
| Tipo: | String |
| Posición: | 3 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ExtensionId
Especifica el identificador de extensión.
| Tipo: | String |
| Posición: | 10 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-InformationAction
Especifica cómo responde este cmdlet a un evento de información.
Los valores permitidos para este parámetro son los siguientes:
- Continuar
- Ignore
- Inquire
- SilentlyContinue
- Detención
- Suspender
| Tipo: | ActionPreference |
| Alias: | infa |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-InformationVariable
Especifica una variable de información.
| Tipo: | String |
| Alias: | iv |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-JoinOption
Especifica la enumeración de la opción de combinación.
| Tipo: | UInt32 |
| Posición: | 7 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Options
Especifica la opción de combinación de enteros sin signo.
| Tipo: | JoinOptions |
| Posición: | 7 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-OUPath
Especifica la ruta de acceso de la unidad organizativa (OU) para la operación de unión a un dominio de AD.
| Tipo: | String |
| Posición: | 8 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Profile
Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.
| Tipo: | AzureSMProfile |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Restart
Especifica si se debe reiniciar el equipo si la operación de combinación se realiza correctamente.
| Tipo: | SwitchParameter |
| Posición: | 4 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Role
Especifica una matriz opcional de roles para especificar la configuración de Escritorio remoto para la configuración del dominio de AD. Si no especifica este parámetro, la configuración del dominio de AD se aplica como configuración predeterminada para todos los roles.
| Tipo: | String[] |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ThumbprintAlgorithm
Especifica un algoritmo hash de huella digital que se usa con la huella digital para identificar el certificado. Este parámetro es opcional y el valor predeterminado es sha1.
| Tipo: | String |
| Posición: | 2 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-UnjoinDomainCredential
Especifica las credenciales (nombre de usuario y contraseña) que se van a unir al dominio de AD.
| Tipo: | PSCredential |
| Posición: | 6 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Version
Especifica la versión de la extensión.
| Tipo: | String |
| Posición: | 9 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-WorkgroupName
Especifica el nombre del grupo de trabajo.
| Tipo: | String |
| Posición: | 3 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-X509Certificate
Especifica un certificado X.509 que se carga automáticamente en el servicio en la nube y se usa para cifrar la configuración privada de la extensión.
| Tipo: | X509Certificate2 |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |