Sdílet prostřednictvím

Get-AzureADMSGroup

  • Reference
Modul:
AzureAD

Získá informace o skupinách v Microsoft Entra ID (přes MS Graph).

Syntaxe

Get-AzureADMSGroup
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSGroup
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSGroup
   -Id <String>
   [-All <Boolean>]
   [<CommonParameters>]

Description

Rutina Get-AzureADMSGroup získá informace o skupinách v ID Microsoft Entra pomocí Microsoft Graphu. Pokud chcete získat skupinu, zadejte parametr ID. Pokud chcete najít konkrétní skupiny, zadejte parametr SearchString nebo Filter. Pokud nezadáte žádné parametry, tato rutina získá všechny skupiny.

Příklady

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

PS C:\> Get-AzureADMSGroup

Id                            : d539a25e-2db2-482a-9dcb-2a0b27fe4f27
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   :
ADSyncOperators
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : ADSyncOperators
OnPremisesSecurityIdentifier  : S-1-5-21-2695029449-1154706203-1063139792-1243
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {}
MembershipRule                :
MembershipRuleProcessingState :


Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   : Project Icarus
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6
OnPremisesSecurityIdentifier  :
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {DynamicMembership}
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece"))
MembershipRuleProcessingState : On

Tento příkaz získá všechny skupiny v ID Microsoft Entra.

Příklad 2: Získání konkrétní skupiny pomocí ID

PS C:\> Get-AzureADMSGroup -Id "d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b"

Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   : Project Icarus
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6
OnPremisesSecurityIdentifier  :
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {DynamicMembership}
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece"))
MembershipRuleProcessingState : On

Tento příkaz získá informace o skupině, která má zadané ID.

Parametry

-All

Pokud je hodnota true, vrátí všechny skupiny. Pokud je false, vrátí počet objektů zadaný parametrem Top.

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

-Filter

Určuje řetězec filtru oData v3.0, který odpovídá sadě skupin.

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

-Id

Určuje ID skupiny, kterou tato rutina získá.

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

-SearchString

Určuje hledaný řetězec. Tato rutina získá skupiny s atributy DisplayName nebo Description, které odpovídají vyhledávacímu řetězci.

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

-Top

Určuje maximální počet záznamů, které tento cmldet získá. Výchozí hodnota je 100.

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

Vstupy

String

System.Nullable'1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Výstupy

Object

Poznámky

Projděte si průvodce migrací get-AzureADMSGroup do Prostředí Microsoft Graph PowerShell.

Tato rutina je aktuálně ve verzi Public Preview. Zatímco je rutina ve verzi Public Preview, můžeme v této rutině provádět změny, které by mohly mít neočekávané účinky. Doporučujeme nepoužívat tuto rutinu v produkčním prostředí.