Udostępnij za pośrednictwem

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 .

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-GroupType

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

Typ:GroupType
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HasErrorsOnly

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HasLicenseErrorsOnly

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

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IsAgentRole

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaxResults

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

Typ:Int32
Position:Named
Domyślna wartość:250
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ObjectId

Określa unikatowy identyfikator obiektu grupy do pobrania.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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 .

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 .

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.