Get-MsolGroup

  • Referencia
Módulo:
MSOnline

Obtiene grupos de Azure Active Directory.

Sintaxis

Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

El cmdlet Get-MsolGroup obtiene grupos de Azure Active Directory. Este cmdlet se puede usar para devolver un único grupo, si especifica el parámetro ObjectId o para buscar en todos los grupos.

Ejemplos

Ejemplo 1: Obtener un grupo mediante un identificador

PS C:\> Get-MsolGroup -ObjectId af407072-7ae1-4b07-a0ca-6634b7396054

Este comando devuelve el objeto de grupo que tiene el identificador especificado.

Ejemplo 2: Obtener todos los grupos

PS C:\> Get-MsolGroup

Este comando devuelve todo el conjunto de grupos para el inquilino, hasta los 250 resultados predeterminados.

Ejemplo 3: Obtener un grupo mediante un nombre principal de usuario

PS C:\> Get-MsolGroup -isAgentRole -UserPrincipalName "pattifuller@contoso.com"

Este comando devuelve los grupos de agente de los que un usuario es miembro. Esto solo se aplica para compañías que tienen privilegios de partner.

Parámetros

-All

Indica que este cmdlet devuelve todos los resultados que encuentra. No especifique este parámetro y el parámetro MaxResults .

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

-GroupType

Especifica el tipo de grupos que se van a obtener. Los valores válidos son Security, MailEnabledSecurity y DistributionList.

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

-HasErrorsOnly

Indica que este cmdlet solo devuelve grupos que tienen errores de validación.

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

-HasLicenseErrorsOnly

Especifica si este cmdlet devuelve solo los grupos de seguridad que tienen errores de licencia.

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

-IsAgentRole

Especifica que este cmdlet solo devuelve grupos de agentes. Este valor solo se aplica a los usuarios asociados.

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

-MaxResults

Especifica el número máximo de resultados que devuelve este cmdlet. El valor predeterminado es 250.

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

-ObjectId

Especifica el identificador de objeto único del grupo que se va a obtener.

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

-SearchString

Especifica una cadena. Este cmdlet devuelve grupos de seguridad que tienen un nombre para mostrar que comienza con esta cadena.

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

-TenantId

Especifica el identificador único del inquilino en el que se va a realizar la operación. El valor predeterminado es el inquilino del usuario actual. Este parámetro solo se aplica a los usuarios asociados.

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

-UserObjectId

Especifica el identificador único de un usuario. Este cmdlet devuelve grupos de seguridad a los que pertenece este usuario. Este parámetro debe usarse junto con el parámetro IsAgentRole .

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

-UserPrincipalName

Especifica el nombre principal de usuario de un usuario. Este cmdlet devuelve grupos de seguridad a los que pertenece este usuario. Este parámetro debe usarse junto con el parámetro IsAgentRole .

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

Salidas

Microsoft.Online.Administration.Group

Este cmdlet devuelve una lista de grupos, que incluyen la siguiente información:

  • CommonName. El nombre común del grupo.

  • Descripción. Una descripción del grupo.

  • DisplayName. El nombre para mostrar del grupo.

  • EmailAddress. Las direcciones de correo electrónico del grupo. No se devuelve para los grupos de seguridad.

  • Errores. Una lista de errores del grupo.

  • GroupType. El tipo de grupo. Los tipos pueden ser SecurityGroup, DistributionList o MailEnabledSecurityGroup.

  • IsSystem. Si este grupo es o no un grupo del sistema (creado por Azure Active Directory). Estos grupos no se pueden actualizar ni quitar.

  • LastDirSyncTime. La fecha y la hora en la que se sincronizó el grupo por última vez.

  • ManagedBy. El propietario del grupo.

  • Idobjeto. El id. de objeto único del grupo.

  • Direcciones de proxy. Las direcciones proxy asociadas a este grupo (solo para grupos habilitados para correo).

  • ValidationStatus. Indica si el grupo tiene errores o no.