Sdílet prostřednictvím

Get-MsolGroup

  • Reference
Modul:
MSOnline

Získá skupiny z Azure Active Directory.

Syntaxe

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

Rutina Get-MsolGroup získává skupiny z Azure Active Directory. Tuto rutinu můžete použít k vrácení jedné skupiny, pokud zadáte parametr ObjectId , nebo k hledání ve všech skupinách.

Příklady

Příklad 1: Získání skupiny pomocí ID

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

Tento příkaz vrátí objekt skupiny se zadaným ID.

Příklad 2: Získání všech skupin

PS C:\> Get-MsolGroup

Tento příkaz vrátí celou sadu skupin pro tenanta až do výchozích 250 výsledků.

Příklad 3: Získání skupiny pomocí hlavního názvu uživatele

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

Tento příkaz vrátí skupiny agentů, do které je uživatel členem. To platí jenom pro společnosti, které mají oprávnění partnera.

Parametry

-All

Označuje, že tato rutina vrátí všechny výsledky, které najde. Nezadávejte tento parametr a parametr MaxResults .

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupType

Určuje typ skupin, které se mají získat. Platné hodnoty jsou Security, MailEnabledSecurity a DistributionList.

Typ:GroupType
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HasErrorsOnly

Označuje, že tato rutina vrací pouze skupiny, u kterých došlo k chybám ověřování.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HasLicenseErrorsOnly

Určuje, jestli tato rutina vrací jenom skupiny zabezpečení, u kterých došlo k chybám licencí.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IsAgentRole

Určuje, že tato rutina vrátí jenom skupiny agentů. Tato hodnota platí jenom pro uživatele partnera.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxResults

Určuje maximální počet výsledků, které tato rutina vrátí. Výchozí hodnota je 250.

Typ:Int32
Position:Named
Default value:250
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ObjectId

Určuje jedinečné ID objektu skupiny, kterou chcete získat.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SearchString

Určuje řetězec. Tato rutina vrátí skupiny zabezpečení, které mají zobrazovaný název začínající tímto řetězcem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TenantId

Určuje jedinečné ID tenanta, na kterém se má operace provést. Výchozí hodnota je tenant aktuálního uživatele. Tento parametr platí jenom pro uživatele partnerů.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UserObjectId

Určuje jedinečné ID uživatele. Tato rutina vrátí skupiny zabezpečení, do kterých tento uživatel patří. Tento parametr musí být použit společně s parametrem IsAgentRole .

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserPrincipalName

Určuje hlavní název uživatele uživatele. Tato rutina vrátí skupiny zabezpečení, do kterých tento uživatel patří. Tento parametr musí být použit společně s parametrem IsAgentRole .

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

Microsoft.Online.Administration.Group

Tato rutina vrátí seznam skupin, které obsahují následující informace:

  • CommonName. Běžný název skupiny.

  • Popis Popis skupiny

  • Displayname. Zobrazovaný název skupiny.

  • Emailaddress. E-mailové adresy skupiny Pro skupiny zabezpečení se tato hodnota nevrátí.

  • Chyby. Seznam chyb pro skupinu.

  • Typ skupiny. Typ skupiny. Typy můžou být SecurityGroup, DistributionList nebo MailEnabledSecurityGroup.

  • IsSystem. Určuje, jestli je tato skupina systémovou skupinou (vytvořenou službou Azure Active Directory). Tyto skupiny nelze aktualizovat ani odebrat.

  • LastDirSyncTime. Datum a čas poslední synchronizace skupiny.

  • Spravováno. Vlastník skupiny.

  • Objectid. Jedinečné ID objektu skupiny

  • Adresy proxy. Proxy adresy přidružené k této skupině (pouze pro poštovní skupiny).

  • ValidationStatus. Určuje, jestli skupina obsahuje nějaké chyby.