New-EntraDomain

Módulo:
Microsoft.Entra.DirectoryManagement Module v1.3

Crea un dominio.

Sintaxis

Default (valor predeterminado) 

New-EntraDomain

    -Name <String>
    [-IsDefault <Boolean>]
    [-SupportedServices <System.Collections.Generic.List`1[System.String]>]
    [<CommonParameters>]

Description

El New-EntraDomain cmdlet crea un dominio en Microsoft Entra ID.

En escenarios delegados, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Los roles mínimos necesarios para esta operación son:

  • Administrador de nombres de dominio

Ejemplos

Ejemplo 1: Crear un dominio

Connect-Entra -Scopes 'Domain.ReadWrite.All'
New-EntraDomain -Name testingDemo.com

Id              AuthenticationType AvailabilityStatus IsAdminManaged IsDefault IsInitial IsRoot IsVerified Manufacturer Model PasswordNotificationWindowInDays PasswordValidityPeriodInDays SupportedServices
--              ------------------ ------------------ -------------- --------- --------- ------ ---------- ------------ ----- -------------------------------- ---------------------------- -----------------
testingDemo.com Managed                               True           False     False     False  False                                                                                       {}

En este ejemplo se muestra cómo crear un nuevo dominio en Microsoft Entra ID.

Ejemplo 2: Creación de un nuevo dominio con una lista de funcionalidades de dominio

Connect-Entra -Scopes 'Domain.ReadWrite.All'
New-EntraDomain -Name testingDemo1.com -SupportedServices @('Email', 'OfficeCommunicationsOnline')

Id               AuthenticationType AvailabilityStatus IsAdminManaged IsDefault IsInitial IsRoot IsVerified Manufacturer Model PasswordNotificationWindowInDays PasswordValidityPeriodInDays SupportedServices
--               ------------------ ------------------ -------------- --------- --------- ------ ---------- ------------ ----- -------------------------------- ---------------------------- -----------------
testingDemo1.com Managed                               True           False     False     False  False                                                                                       {}

En este ejemplo se muestra cómo crear un dominio con los servicios especificados en Microsoft Entra ID.

Ejemplo 3: Crear un nuevo dominio y crear si el nuevo usuario predeterminado crea

Connect-Entra -Scopes 'Domain.ReadWrite.All'
New-EntraDomain -Name testingDemo2.com -IsDefault $True

Id               AuthenticationType AvailabilityStatus IsAdminManaged IsDefault IsInitial IsRoot IsVerified Manufacturer Model PasswordNotificationWindowInDays PasswordValidityPeriodInDays SupportedServices
--               ------------------ ------------------ -------------- --------- --------- ------ ---------- ------------ ----- -------------------------------- ---------------------------- -----------------
testingDemo2.com Managed                               True           False     False     False  False                                                                                       {}

En este ejemplo se muestra cómo crear un nuevo dominio en Microsoft Entra ID y se marca como el valor predeterminado que se usará para la creación de nuevo usuario.

Parámetros

-IsDefault

Indica si se trata del dominio predeterminado que se usa para la creación de usuarios.

Solo hay un dominio predeterminado por empresa.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre completo del dominio.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SupportedServices

Funcionalidades asignadas al dominio.

Propiedades de parámetro

Tipo:

System.Collections.Generic.List`1[System.String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.