Share via

Get-MsolGroup

  • Odwołanie
Moduł:
MSOnline

Pobiera grupy z usługi Azure Active Directory.

Składnia

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>]

Opis

Polecenie cmdlet Get-MsolGroup pobiera grupy z usługi Azure Active Directory. To polecenie cmdlet może służyć do zwracania pojedynczej grupy, jeśli określisz parametr ObjectId lub wyszukać we wszystkich grupach.

Przykłady

Przykład 1. Pobieranie grupy przy użyciu identyfikatora

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

To polecenie zwraca obiekt grupy, który ma określony identyfikator.

Przykład 2. Pobieranie wszystkich grup

PS C:\> Get-MsolGroup

To polecenie zwraca cały zestaw grup dla dzierżawy do domyślnych 250 wyników.

Przykład 3. Pobieranie grupy przy użyciu głównej nazwy użytkownika

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

To polecenie zwraca grupy agentów, do których należy użytkownik. Dotyczy to tylko firm, które mają uprawnienia partnera.

Parametry

-All

Wskazuje, że to polecenie cmdlet zwraca wszystkie znalezione wyniki. Nie należy określać tego parametru i parametru MaxResults .

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

-GroupType

Określa typ grup do pobrania. Prawidłowe wartości to Security, MailEnabledSecurity i DistributionList.

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

-HasErrorsOnly

Wskazuje, że to polecenie cmdlet zwraca tylko grupy, które mają błędy walidacji.

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

-HasLicenseErrorsOnly

Określa, czy to polecenie cmdlet zwraca tylko grupy zabezpieczeń, które mają błędy licencji.

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

-IsAgentRole

Określa, że to polecenie cmdlet zwraca tylko grupy agentów. Ta wartość ma zastosowanie tylko do użytkowników partnerów.

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

-MaxResults

Określa maksymalną liczbę wyników zwracanych przez to polecenie cmdlet. Wartość domyślna to 250.

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

-ObjectId

Określa unikatowy identyfikator obiektu grupy do pobrania.

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

-SearchString

Określa ciąg. To polecenie cmdlet zwraca grupy zabezpieczeń, które mają nazwę wyświetlaną rozpoczynającą się od tego ciągu.

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

-TenantId

Określa unikatowy identyfikator dzierżawy, w której ma być wykonywana operacja. Wartość domyślna to dzierżawa bieżącego użytkownika. Ten parametr ma zastosowanie tylko do użytkowników partnerów.

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

-UserObjectId

Określa unikatowy identyfikator użytkownika. To polecenie cmdlet zwraca grupy zabezpieczeń, do których należy ten użytkownik. Ten parametr musi być używany wraz z parametrem IsAgentRole .

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

-UserPrincipalName

Określa główną nazwę użytkownika. To polecenie cmdlet zwraca grupy zabezpieczeń, do których należy ten użytkownik. Ten parametr musi być używany wraz z parametrem IsAgentRole .

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

Dane wyjściowe

Microsoft.Online.Administration.Group

To polecenie cmdlet zwraca listę grup, które zawierają następujące informacje:

  • CommonName. Nazwa pospolita grupy.

  • Opis Opis grupy.

  • Displayname. Nazwa wyświetlana grupy.

  • Emailaddress. Adresy e-mail grupy. Nie jest to zwracane dla grup zabezpieczeń.

  • Błędy. Lista błędów dla grupy.

  • Grouptype. Typ grupy. Mogą to być typy SecurityGroup, DistributionList lub MailEnabledSecurityGroup.

  • IsSystem. Określa, czy ta grupa jest grupą systemową (utworzoną przez usługę Azure Active Directory). Tych grup nie można zaktualizować ani usunąć.

  • LastDirSyncTime. Data i godzina ostatniej synchronizacji grupy.

  • Zarządzane przez. Właściciel grupy.

  • Objectid. Unikatowy identyfikator obiektu grupy.

  • Adresy serwera proxy. Adresy serwera proxy skojarzone z tą grupą (tylko dla grup z włączoną obsługą poczty).

  • Validationstatus. Bez względu na to, czy grupa ma jakiekolwiek błędy.