Get-MsolGroup

  • Referens
Modul:
MSOnline

Hämtar grupper från 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

Cmdleten Get-MsolGroup hämtar grupper från Azure Active Directory. Den här cmdleten kan användas för att returnera en enda grupp, om du anger parametern ObjectId eller för att söka i alla grupper.

Exempel

Exempel 1: Hämta en grupp med hjälp av ett ID

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

Det här kommandot returnerar gruppobjektet som har det angivna ID:t.

Exempel 2: Hämta alla grupper

PS C:\> Get-MsolGroup

Det här kommandot returnerar hela uppsättningen grupper för klientorganisationen, upp till standardresultatet på 250.

Exempel 3: Hämta en grupp med hjälp av ett huvudnamn för användaren

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

Det här kommandot returnerar de agentgrupper som en användare är medlem i. Detta gäller endast för företag som har partnerprivilegier.

Parametrar

-All

Anger att denna cmdlet returnerar alla resultat som hittas. Ange inte den här parametern och parametern MaxResults .

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

-GroupType

Anger vilken typ av grupper som ska hämtas. Giltiga värden är Security, MailEnabledSecurity och DistributionList.

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

-HasErrorsOnly

Anger att denna cmdlet endast returnerar grupper som har valideringsfel.

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

-HasLicenseErrorsOnly

Anger om denna cmdlet endast returnerar säkerhetsgrupper som har licensfel.

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

-IsAgentRole

Anger att denna cmdlet endast returnerar agentgrupper. Det här värdet gäller endast för partneranvändare.

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

-MaxResults

Anger det maximala antalet resultat som denna cmdlet returnerar. Standardvärdet är 250.

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

-ObjectId

Anger det unika objekt-ID för gruppen som ska hämtas.

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

-SearchString

Anger en sträng. Den här cmdleten returnerar säkerhetsgrupper som har ett visningsnamn som börjar med den här strängen.

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

-TenantId

Anger det unika ID:t för den klientorganisation som åtgärden ska utföras på. Standardvärdet är den aktuella användarens klientorganisation. Den här parametern gäller endast för partneranvändare.

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

-UserObjectId

Anger en användares unika ID. Den här cmdleten returnerar säkerhetsgrupper som användaren tillhör. Den här parametern måste användas tillsammans med parametern IsAgentRole .

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

-UserPrincipalName

Anger användarens huvudnamn för en användare. Den här cmdleten returnerar säkerhetsgrupper som användaren tillhör. Den här parametern måste användas tillsammans med parametern IsAgentRole .

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

Utdata

Microsoft.Online.Administration.Group

Den här cmdleten returnerar en lista över grupper som innehåller följande information:

  • CommonName. Gruppens eget namn.

  • Beskrivning. En beskrivning av gruppen.

  • Displayname. Gruppens visningsnamn.

  • Emailaddress. Gruppens e-postadresser. Detta returneras inte för säkerhetsgrupper.

  • Fel. En lista över fel för gruppen.

  • GroupType. Gruppens typ. Typer kan vara SecurityGroup, DistributionList eller MailEnabledSecurityGroup.

  • IsSystem. Oavsett om den här gruppen är en systemgrupp (skapad av Azure Active Directory). Dessa grupper kan inte uppdateras eller tas bort.

  • LastDirSyncTime. Datum och tid då gruppen senast synkroniserades.

  • ManagedBy. Gruppens ägare.

  • Objectid. Gruppens unika objekt-ID.

  • Proxyadresser. Proxyadresserna som är associerade med den här gruppen (endast för e-postaktiverade grupper).

  • ValidationStatus. Om gruppen har några fel eller inte.