Get-MsolGroup
Získá skupiny z 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
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 |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GroupType
Určuje typ skupin, které se mají získat. Platné hodnoty jsou Security, MailEnabledSecurity a DistributionList.
Typ: | GroupType |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsAgentRole
Určuje, že tato rutina vrátí jenom skupiny agentů. Tato hodnota platí jenom pro uživatele partnera.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxResults
Určuje maximální počet výsledků, které tato rutina vrátí. Výchozí hodnota je 250.
Typ: | Int32 |
Position: | Named |
výchozí hodnota: | 250 |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Určuje jedinečné ID objektu skupiny, kterou chcete získat.
Typ: | Guid |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro