Get-MsolGroup
Obtiene grupos de Azure Active Directory.
Syntax
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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GroupType
Especifica el tipo de grupos que se van a obtener. Los valores válidos son Security, MailEnabledSecurity y DistributionList.
Type: | GroupType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HasErrorsOnly
Indica que este cmdlet devuelve solo grupos que tienen errores de validación.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HasLicenseErrorsOnly
Especifica si este cmdlet devuelve solo los grupos de seguridad que tienen errores de licencia.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsAgentRole
Especifica que este cmdlet devuelve solo grupos de agentes. Este valor solo se aplica a los usuarios asociados.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxResults
Especifica el número máximo de resultados que devuelve este cmdlet. El valor predeterminado es 250.
Type: | Int32 |
Position: | Named |
Default value: | 250 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Especifica el identificador de objeto único del grupo que se va a obtener.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SearchString
Especifica una cadena. Este cmdlet devuelve grupos de seguridad que tienen un nombre para mostrar que comienza con esta cadena.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserObjectId
Especifica el identificador único de un usuario. Este cmdlet devuelve grupos de seguridad a los que pertenece este usuario. Este parámetro se debe usar junto con el parámetro IsAgentRole .
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 se debe usar junto con el parámetro IsAgentRole .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 de proxy asociadas a este grupo (solo para grupos habilitados para correo).
ValidationStatus. Indica si el grupo tiene errores o no.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de