Share via


Get-AzureADMSGroup

Ottiene informazioni sui gruppi in Azure AD.

Sintassi

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>]

Descrizione

Il cmdlet Get-AzureADMSGroup ottiene informazioni sui gruppi in Azure Active Directory (Azure AD). Per ottenere un gruppo, specificare il parametro Id. Specificare il parametro SearchString o Filter per trovare gruppi specifici. Se non si specificano parametri, questo cmdlet ottiene tutti i gruppi.

Esempio

Esempio 1: Ottenere tutti i gruppi

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

Questo comando ottiene tutti i gruppi in Azure AD.

Esempio 2: Ottenere un gruppo specifico usando un ID

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

Questo comando ottiene informazioni per il gruppo con l'ID specificato.

Esempio 3: Ottenere i valori delle proprietà AssignedLabels e DisplayName per tutti i gruppi

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

Questo comando ottiene i valori delle proprietà AssignedLabels e DisplayName per tutti i gruppi.

La proprietà del gruppo AssignedLabels può essere recuperata solo dal parametro Select.

Esempio 4: Ottenere i valori delle proprietà AssignedLabels e DisplayName per un gruppo

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

Questo comando ottiene i valori delle proprietà AssignedLabels e DisplayName per un gruppo specifico.

La proprietà del gruppo AssignedLabels può essere recuperata solo dal parametro Select.

Parametri

-All

Se true, restituisce tutti i gruppi. Se false, restituire il numero di oggetti specificati dal parametro Top

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

-Filter

Specifica una stringa di filtro oData v3.0 in modo che corrisponda a un set di gruppi.

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

-Id

Specifica l'ID del gruppo che ottiene questo cmdlet.

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

-SearchString

Specifica una stringa di ricerca. Questo cmdlet ottiene gruppi con attributi DisplayName o Description che corrispondono alla stringa di ricerca.

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

-Select

Specifica un elenco di proprietà di gruppo da recuperare.

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

-Top

Specifica il numero massimo di record che ottiene questo cmldet. Il valore predefinito è 100.

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

Input

String

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

Output

Object

Note

Questo cmdlet è attualmente disponibile in anteprima pubblica. Anche se un cmdlet è in anteprima pubblica, è possibile apportare modifiche al cmdlet che potrebbero avere effetti imprevisti. È consigliabile non usare questo cmdlet in un ambiente di produzione.