Compartir a través de

Get-AzureADMSGroup

  • Referencia
Módulo:
AzureADPreview

Obtiene información sobre los grupos de Azure AD.

Sintaxis

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 del 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.

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

-Filter

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

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

-Id

Especifica el identificador del grupo que obtiene este cmdlet.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

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

-Select

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

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

-Top

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

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

Entradas

String

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

Salidas

Object

Notas

Este cmdlet está 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.