Share via

Get-MsolGroup

  • Referencia
Modul:
MSOnline

Lekéri a csoportokat az Azure Active Directoryból.

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

A Get-MsolGroup parancsmag lekéri a csoportokat az Azure Active Directoryból. Ez a parancsmag használható egyetlen csoport visszaadására, ha megadja az ObjectId paramétert, vagy az összes csoportban való kereséshez.

Példák

1. példa: Csoport lekérése azonosítóval

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

Ez a parancs a megadott azonosítóval rendelkező csoportobjektumot adja vissza.

2. példa: Az összes csoport lekérése

PS C:\> Get-MsolGroup

Ez a parancs a bérlő teljes csoportkészletét adja vissza az alapértelmezett 250 eredményig.

3. példa: Csoport lekérése egyszerű felhasználónévvel

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

Ez a parancs azokat az ügynökcsoportokat adja vissza, amelyeknek a felhasználó tagja. Ez csak a partneri jogosultságokkal rendelkező vállalatokra vonatkozik.

Paraméterek

-All

Azt jelzi, hogy ez a parancsmag az összes talált eredményt visszaadja. Ne adja meg ezt a paramétert és a MaxResults paramétert .

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

-GroupType

Meghatározza a lekérendő csoportok típusát. Az érvényes értékek: Security, MailEnabledSecurity és DistributionList.

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

-HasErrorsOnly

Azt jelzi, hogy ez a parancsmag csak érvényesítési hibákat tartalmazó csoportokat ad vissza.

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

-HasLicenseErrorsOnly

Meghatározza, hogy ez a parancsmag csak licenchibákkal rendelkező biztonsági csoportokat ad-e vissza.

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

-IsAgentRole

Azt adja meg, hogy ez a parancsmag csak ügynökcsoportokat ad vissza. Ez az érték csak a partnerfelhasználókra vonatkozik.

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

-MaxResults

A parancsmag által visszaadott eredmények maximális számát adja meg. Az alapértelmezett érték 250.

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

-ObjectId

Megadja a lekérni kívánt csoport egyedi objektumazonosítóját.

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

-SearchString

Sztringet ad meg. Ez a parancsmag olyan biztonsági csoportokat ad vissza, amelyek megjelenítendő neve ezzel a sztringgel kezdődik.

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

-TenantId

Annak a bérlőnek az egyedi azonosítóját adja meg, amelyen a műveletet végre szeretné hajtani. Az alapértelmezett érték az aktuális felhasználó bérlője. Ez a paraméter csak a partnerfelhasználókra vonatkozik.

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

-UserObjectId

A felhasználó egyedi azonosítóját adja meg. Ez a parancsmag olyan biztonsági csoportokat ad vissza, amelyekhez a felhasználó tartozik. Ezt a paramétert az IsAgentRole paraméterrel együtt kell használni.

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

-UserPrincipalName

Megadja egy felhasználó egyszerű felhasználónevét. Ez a parancsmag olyan biztonsági csoportokat ad vissza, amelyekhez a felhasználó tartozik. Ezt a paramétert az IsAgentRole paraméterrel együtt kell használni.

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

Kimenetek

Microsoft.Online.Administration.Group

Ez a parancsmag a csoportok listáját adja vissza, amelyek a következő információkat tartalmazzák:

  • CommonName. A csoport köznapi neve.

  • Leírás. A csoport leírása.

  • Displayname. A csoport megjelenítendő neve.

  • E-mail-cím. A csoport e-mail-címei. Ez biztonsági csoportok esetén nem jelenik meg.

  • Hibák. A csoport hibáinak listája.

  • GroupType. A csoport típusa. A típusok lehetnek SecurityGroup, DistributionList vagy MailEnabledSecurityGroup.

  • IsSystem. Azt jelzi, hogy ez a csoport rendszercsoport-e (amelyet az Azure Active Directory hoz létre). Ezek a csoportok nem frissíthetők és nem távolíthatók el.

  • LastDirSyncTime. A csoport utolsó szinkronizálásának dátuma és időpontja.

  • ManagedBy. A csoport tulajdonosa.

  • ObjectId. A csoport egyedi objektumazonosítója.

  • Proxycímek. A csoporthoz társított proxycímek (csak levelezési csoportok esetén).

  • ValidationStatus. Azt jelzi, hogy a csoportnak vannak-e hibái.