Get-MsolGroup

  • Referentie
Module:
MSOnline

Hiermee haalt u groepen op uit 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

Met de cmdlet Get-MsolGroup worden groepen opgehaald uit Azure Active Directory. Deze cmdlet kan worden gebruikt om één groep te retourneren, als u de parameter ObjectId opgeeft of om te zoeken in alle groepen.

Voorbeelden

Voorbeeld 1: Een groep ophalen met behulp van een id

PS C:\> Get-MsolGroup -ObjectId af407072-7ae1-4b07-a0ca-6634b7396054

Met deze opdracht wordt het groepsobject met de opgegeven id geretourneerd.

Voorbeeld 2: Alle groepen ophalen

PS C:\> Get-MsolGroup

Met deze opdracht wordt de volledige set groepen voor de tenant geretourneerd, tot de standaard 250 resultaten.

Voorbeeld 3: Een groep ophalen met behulp van een user principal name

PS C:\> Get-MsolGroup -isAgentRole -UserPrincipalName "pattifuller@contoso.com"

Met deze opdracht worden de agentgroepen geretourneerd waarvan een gebruiker lid is. Dit geldt alleen voor bedrijven met partnerbevoegdheden.

Parameters

-All

Geeft aan dat deze cmdlet alle resultaten retourneert die worden gevonden. Geef deze parameter en de parameter MaxResults niet op.

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

-GroupType

Hiermee geeft u het type groepen op dat moet worden get. Geldige waarden zijn Beveiliging, MailEnabledSecurity en DistributionList.

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

-HasErrorsOnly

Geeft aan dat deze cmdlet alleen groepen retourneert die validatiefouten hebben.

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

-HasLicenseErrorsOnly

Hiermee geeft u op of deze cmdlet alleen beveiligingsgroepen met licentiefouten retourneert.

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

-IsAgentRole

Hiermee geeft u op dat deze cmdlet alleen agentgroepen retourneert. Deze waarde geldt alleen voor partnergebruikers.

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

-MaxResults

Hiermee geeft u het maximum aantal resultaten op dat door deze cmdlet wordt geretourneerd. De standaardwaarde is 250.

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

-ObjectId

Hiermee geeft u de unieke object-id van de groep op die moet worden opgehaald.

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

-SearchString

Hiermee geeft u een tekenreeks. Deze cmdlet retourneert beveiligingsgroepen met een weergavenaam die begint met deze tekenreeks.

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

-TenantId

Hiermee geeft u de unieke id van de tenant op waarop de bewerking moet worden uitgevoerd. De standaardwaarde is de tenant van de huidige gebruiker. Deze parameter is alleen van toepassing op partnergebruikers.

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

-UserObjectId

Hiermee geeft u de unieke id van een gebruiker. Deze cmdlet retourneert beveiligingsgroepen waartoe deze gebruiker behoort. Deze parameter moet samen met de parameter IsAgentRole worden gebruikt.

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

-UserPrincipalName

Hiermee geeft u de user principal name van een gebruiker. Deze cmdlet retourneert beveiligingsgroepen waartoe deze gebruiker behoort. Deze parameter moet samen met de parameter IsAgentRole worden gebruikt.

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

Uitvoerwaarden

Microsoft.Online.Administration.Group

Deze cmdlet retourneert een lijst met groepen, waaronder de volgende informatie:

  • CommonName. De algemene naam van de groep.

  • Beschrijving Een beschrijving van de groep.

  • Displayname. De weergavenaam van de groep.

  • Emailaddress. De e-mailadressen van de groep. Dit wordt niet geretourneerd voor beveiligingsgroepen.

  • Fouten. Een lijst met fouten voor de groep.

  • GroupType. Het type van de groep. Typen kunnen SecurityGroup, DistributionList of MailEnabledSecurityGroup zijn.

  • IsSystem. Of deze groep al dan niet een systeemgroep is (gemaakt door Azure Active Directory). Deze groepen kunnen niet worden bijgewerkt of verwijderd.

  • LastDirSyncTime. De datum en tijd waarop de groep voor het laatst is gesynchroniseerd.

  • ManagedBy. De eigenaar van de groep.

  • ObjectId. De unieke object-id van de groep.

  • Proxyadressen. De proxyadressen die aan deze groep zijn gekoppeld (alleen voor groepen met e-mail).

  • ValidationStatus. Of de groep al dan niet fouten bevat.