Delen via

Get-AzureADMSGroup

  • Referentie
Module:
AzureADPreview

Hiermee haalt u informatie op over groepen in Azure AD.

Syntaxis

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

De cmdlet Get-AzureADMSGroup haalt informatie op over groepen in Azure Active Directory (Azure AD). Geef de parameter Id op om een groep op te halen. Geef de parameter SearchString of Filter op om bepaalde groepen te zoeken. Als u geen parameters opgeeft, worden met deze cmdlet alle groepen opgevraagd.

Voorbeelden

Voorbeeld 1: Alle groepen ophalen

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

Met deze opdracht worden alle groepen in Azure AD opgeslagen.

Voorbeeld 2: een specifieke groep ophalen met behulp van een 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

Met deze opdracht wordt informatie opgehaald voor de groep met de opgegeven id.

Voorbeeld 3: De eigenschapswaarden AssignedLabels en DisplayName ophalen voor alle groepen

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

Met deze opdracht worden de eigenschapswaarden AssignedLabels en DisplayName opgehaald voor alle groepen.

De groepseigenschap AssignedLabels kan alleen worden opgehaald door de select-parameter.

Voorbeeld 4: De eigenschapswaarden AssignedLabels en DisplayName ophalen voor een groep

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

Met deze opdracht worden de eigenschapswaarden AssignedLabels en DisplayName voor een specifieke groep opgehaald.

De groepseigenschap AssignedLabels kan alleen worden opgehaald door de select-parameter.

Parameters

-All

Als dit waar is, retourneert u alle groepen. Als onwaar, retourneert u het aantal objecten dat is opgegeven door de topparameter

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Filter

Hiermee geeft u een oData v3.0-filtertekenreeks op die overeenkomt met een set groepen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Id

Hiermee geeft u de id van de groep die deze cmdlet ophaalt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SearchString

Hiermee geeft u een zoektekenreeks op. Met deze cmdlet worden groepen opgehaald met DisplayName- of Description-kenmerken die overeenkomen met de zoekreeks.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Select

Hiermee geeft u een lijst met groepseigenschappen op om op te halen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Top

Hiermee geeft u het maximum aantal records op dat deze cmldet krijgt. De standaardwaarde is 100.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

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

Uitvoerwaarden

Object

Notities

Deze cmdlet is momenteel in openbare preview. Terwijl een cmdlet zich in openbare preview bevindt, kunnen we wijzigingen aanbrengen in de cmdlet die onverwachte gevolgen kunnen hebben. We raden u aan deze cmdlet niet te gebruiken in een productieomgeving.