Compartir a través de

New-AzureADMSGroup

  • Referencia
Módulo:
AzureAD

Crea un grupo de Azure AD.

Sintaxis

New-AzureADMSGroup
   [-Description <String>]
   -DisplayName <String>
   [-IsAssignableToRole <Boolean>]
   -MailEnabled <Boolean>
   -MailNickname <String>
   -SecurityEnabled <Boolean>
   [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
   [-Visibility <String>]
   [<CommonParameters>]

Description

El cmdlet New-AzureADMSGroup crea un grupo de Azure Active Directory (Azure AD).

Ejemplos

Ejemplo: Creación de un grupo asignable al rol

PS C:\> New-AzureADMSGroup -DisplayName "HelpDesk admin group" -Description "Group assignable to role" -MailEnabled $False -MailNickname "helpDeskAdminGroup" -SecurityEnabled $True -IsAssignableToRole $True -Visibility "Private"

Id                            : 1026185e-25df-4522-a380-7ab697a7241c
Description                   : Group assignable to role
OnPremisesSyncEnabled         : 
DisplayName                   : HelpDesk admin group
Mail                          : 
MailEnabled                   : False
IsAssignableToRole            : True 
MailNickname                  : helpDeskAdminGroup
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {}

Parámetros

-Description

Especifica una descripción para el grupo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayName

Especifica un nombre para mostrar para el grupo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GroupTypes

Especifica que el grupo es un grupo unificado o dinámico.

Notas:

  • Este parámetro no se puede usar actualmente para crear grupos dinámicos. Para crear un grupo dinámico en PowerShell, debe usar el módulo versión preliminar de Azure AD.
Tipo:List<T>[String]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsAssignableToRole

Indica si el grupo se puede asignar a un rol. Esta propiedad solo se puede establecer en el momento de la creación del grupo y no se puede modificar en un grupo existente.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MailEnabled

Indica si este grupo está habilitado para correo.

Actualmente, no se pueden crear grupos habilitados para correo en Azure AD.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MailNickname

Especifica un alias de correo para el grupo. Si MailEnabled es $False debe especificar un alias de correo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecurityEnabled

Indica si el grupo está habilitado para la seguridad. En el caso de los grupos de seguridad, este valor debe ser $True.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Visibility

Especifica la visibilidad del contenido y la lista de miembros del grupo. Este parámetro puede tomar uno de los siguientes valores:

  • "Público": cualquier persona puede ver el contenido del grupo
  • "Privado": solo los miembros pueden ver el contenido del grupo.
  • "HiddenMembership": solo los miembros pueden ver el contenido del grupo y solo los miembros, propietarios, administrador global o de empresa, administrador de usuarios y administradores del departamento de soporte técnico pueden ver la lista de miembros del grupo.

Si no se proporciona ningún valor, el valor predeterminado será "Public".

Notas:

  • Este parámetro solo es válido para los grupos que tienen groupType establecido en "Unified".
  • Si un grupo tiene este atributo establecido en "HiddenMembership", no se puede cambiar más adelante.
  • Cualquier persona puede unirse a un grupo que tenga este atributo establecido en "Public". Si el atributo se establece en Private o HiddenMembership, solo los propietarios pueden agregar nuevos miembros al grupo y las solicitudes para unirse al grupo necesitan aprobación de los propietarios.
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

Object

Notas

Consulte la guía de migración de New-AzureADMSGroup a Microsoft Graph PowerShell.

Este cmdlet se encuentra actualmente en versión preliminar pública. Aunque un cmdlet está en versión preliminar pública, podemos realizar cambios en el cmdlet que podrían tener efectos inesperados. Se recomienda no usar este cmdlet en un entorno de producción.