Get-AzureADMSGroup

  • Referencia
Módulo:
AzureADPreview

Obtiene información sobre los grupos de Azure AD.

Syntax

Get-AzureADMSGroup
   [-All <Boolean>]
   [-Top <Int32>]
   [-Select <String>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSGroup
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSGroup
   -Id <String>
   [-All <Boolean>]
   [-Select <String>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureADMSGroup obtiene información sobre los grupos de Azure Active Directory (Azure AD). Para obtener un grupo, especifique el parámetro Id. Especifique el parámetro SearchString o Filter para buscar grupos concretos. Si no especifica ningún parámetro, este cmdlet obtiene todos los grupos.

Ejemplos

Ejemplo 1: Obtener todos los grupos

PS C:\> Get-AzureADMSGroup

Id                            : d539a25e-2db2-482a-9dcb-2a0b27fe4f27 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : 
ADSyncOperators 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False
MailNickname                  : ADSyncOperators 
OnPremisesSecurityIdentifier  : S-1-5-21-2695029449-1154706203-1063139792-1243 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {} 
MembershipRule                : 
MembershipRuleProcessingState :


Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : Project Icarus 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False 
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6 
OnPremisesSecurityIdentifier  : 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {DynamicMembership} 
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece")) 
MembershipRuleProcessingState : On

Este comando obtiene todos los grupos de Azure AD.

Ejemplo 2: Obtener un grupo específico mediante un identificador

PS C:\> Get-AzureADMSGroup -Id "d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b"

Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : Project Icarus 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False 
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6 
OnPremisesSecurityIdentifier  : 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {DynamicMembership} 
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece")) 
MembershipRuleProcessingState : On

Este comando obtiene información para el grupo que tiene el identificador especificado.

Ejemplo 3: Obtener valores de propiedad AssignedLabels y DisplayName para todos los grupos

PS C:\> Get-AzureADMSGroup -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 2

Este comando obtiene los valores de propiedad AssignedLabels y DisplayName para todos los grupos.

La propiedad de grupo AssignedLabels solo se puede recuperar mediante el parámetro Select.

Ejemplo 4: Obtener valores de propiedad AssignedLabels y DisplayName para un grupo

PS C:\> Get-AzureADMSGroup -Id "11111111-1111-1111-1111-111111111111" -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

Este comando obtiene los valores de propiedad AssignedLabels y DisplayName para un grupo específico.

La propiedad de grupo AssignedLabels solo se puede recuperar mediante el parámetro Select.

Parámetros

-All

Si es true, devuelva todos los grupos. Si es false, devuelva el número de objetos especificados por el parámetro Top.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Filter

Especifica una cadena de filtro de oData v3.0 para que coincida con un conjunto de grupos.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

Especifica el identificador del grupo que obtiene este cmdlet.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

Especifica una cadena de búsqueda. Este cmdlet obtiene grupos que tienen atributos DisplayName o Description que coinciden con la cadena de búsqueda.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Select

Especifica una lista de propiedades de grupo que se van a recuperar.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Top

Especifica el número máximo de registros que obtiene este cmldet. El valor predeterminado es 100.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

System.Nullable'1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Salidas

Object

Notas

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.