Sdílet prostřednictvím

Get-AzureADMSGroup

  • Reference
Modul:
AzureADPreview

Získá informace o skupinách v Azure AD.

Syntax

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

Description

Rutina Get-AzureADMSGroup získá informace o skupinách v Azure Active Directory (Azure AD). 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 Azure AD.

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.

Příklad 3: Získání hodnot vlastností AssignedLabels a DisplayName pro všechny skupiny

PS C:\> Get-AzureADMSGroup -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 2

Tento příkaz získá hodnoty vlastnosti AssignedLabels a DisplayName pro všechny skupiny.

Vlastnost skupiny AssignedLabels lze načíst pouze pomocí parametru Select.

Příklad 4: Získání hodnot vlastností AssignedLabels a DisplayName pro skupinu

PS C:\> Get-AzureADMSGroup -Id "11111111-1111-1111-1111-111111111111" -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

Tento příkaz získá hodnoty vlastností AssignedLabels a DisplayName pro konkrétní skupinu.

Vlastnost skupiny AssignedLabels lze načíst pouze pomocí parametru Select.

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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-Filter

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

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

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

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-Select

Určuje seznam vlastností skupiny, které se mají načíst.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-Top

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

Typ:Int32
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

Vstupy

String

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

Výstupy

Object

Poznámky

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í.