Compartir a través de

New-AzureADMSGroup

Módulo:
AzureAD Module

Crea un grupo de Azure AD.

Sintaxis

Default (Es el valor predeterminado). 

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: Crear un grupo asignable a la función

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.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-DisplayName

Especifica un nombre para mostrar para el grupo.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-GroupTypes

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

Notas:

  • Actualmente, este parámetro no se puede utilizar para crear grupos dinámicos. Para crear un grupo dinámico en PowerShell, debe usar el módulo de vista previa de Azure AD.

Propiedades del parámetro

Tipo:

List<T>[String]

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-MailEnabled

Indica si este grupo está habilitado para correo.

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

Propiedades del parámetro

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

Conjuntos de parámetros

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

-MailNickname

Especifica un apodo de correo para el grupo. Si MailEnabled es $False aún debe especificar un apodo de correo.

Propiedades del parámetro

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

Conjuntos de parámetros

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

-SecurityEnabled

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

Propiedades del parámetro

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

Conjuntos de parámetros

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

-Visibility

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

  • "Público": cualquiera 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/de la 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á "Público".

Notas:

  • Este parámetro solo es válido para grupos que tienen groupType establecido en "Unified".
  • Si un grupo tiene este atributo establecido en "HiddenMembership", no se puede cambiar más adelante.
  • Cualquiera puede unirse a un grupo que tenga este atributo establecido en "Público". 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 la aprobación de los propietarios.

Propiedades del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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.

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. Mientras un cmdlet está en versión preliminar pública, es posible que se realicen cambios en el cmdlet que podrían tener efectos inesperados. Se recomienda no usar este cmdlet en un entorno de producción.