Get-MsolGroup

  • Başvuru
Modül:
MSOnline

Azure Active Directory'den grupları alır.

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

Get-MsolGroup cmdlet'i, Azure Active Directory'den grupları alır. Bu cmdlet, ObjectId parametresini belirtirseniz tek bir grup döndürmek veya tüm gruplar içinde arama yapmak için kullanılabilir.

Örnekler

Örnek 1: Kimlik kullanarak grup alma

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

Bu komut, belirtilen kimliği içeren grup nesnesini döndürür.

Örnek 2: Tüm grupları alma

PS C:\> Get-MsolGroup

Bu komut, kiracı için varsayılan 250 sonucta kadar grup kümesinin tamamını döndürür.

Örnek 3: Kullanıcı asıl adını kullanarak grup alma

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

Bu komut, kullanıcının üyesi olduğu aracı gruplarını döndürür. Bu yalnızca iş ortağı ayrıcalıklarına sahip şirketler için geçerlidir.

Parametreler

-All

Bu cmdlet'in bulduğu tüm sonuçları döndürdüğünü gösterir. Bu parametreyi ve MaxResults parametresini belirtmeyin.

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

-GroupType

Alınacak grupların türünü belirtir. Geçerli değerler Security, MailEnabledSecurity ve DistributionList değerleridir.

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

-HasErrorsOnly

Bu cmdlet'in yalnızca doğrulama hataları olan grupları döndürdüğünü gösterir.

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

-HasLicenseErrorsOnly

Bu cmdlet'in yalnızca lisans hataları olan güvenlik gruplarını döndürip döndürmediğini belirtir.

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

-IsAgentRole

Bu cmdlet'in yalnızca aracı gruplarını döndürdüğünü belirtir. Bu değer yalnızca iş ortağı kullanıcıları için geçerlidir.

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

-MaxResults

Bu cmdlet'in döndürdüğü en fazla sonuç sayısını belirtir. Varsayılan değer 250'dir.

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

-ObjectId

Alınacak grubun benzersiz nesne kimliğini belirtir.

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

-SearchString

Bir dize belirtir. Bu cmdlet, bu dizeyle başlayan görünen ada sahip güvenlik gruplarını döndürür.

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

-TenantId

İşlemin gerçekleştirildiği kiracının benzersiz kimliğini belirtir. Varsayılan değer, geçerli kullanıcının kiracısıdır. Bu parametre yalnızca iş ortağı kullanıcıları için geçerlidir.

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

-UserObjectId

Kullanıcının benzersiz kimliğini belirtir. Bu cmdlet, bu kullanıcının ait olduğu güvenlik gruplarını döndürür. Bu parametre IsAgentRole parametresiyle birlikte kullanılmalıdır.

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

-UserPrincipalName

Bir kullanıcının kullanıcı asıl adını belirtir. Bu cmdlet, bu kullanıcının ait olduğu güvenlik gruplarını döndürür. Bu parametre IsAgentRole parametresiyle birlikte kullanılmalıdır.

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

Çıkışlar

Microsoft.Online.Administration.Group

Bu cmdlet, aşağıdaki bilgileri içeren bir grup listesi döndürür:

  • CommonName. Grubun ortak adı.

  • Açıklama. Grubun açıklaması.

  • Displayname. Grubun görünen adı.

  • Emailaddress. Grubun e-posta adresleri. Bu, güvenlik grupları için döndürülmedi.

  • Hata. Grup için hataların listesi.

  • GroupType. Grubun türü. Türler SecurityGroup, DistributionList veya MailEnabledSecurityGroup olabilir.

  • IsSystem. Bu grubun bir sistem grubu olup olmadığı (Azure Active Directory tarafından oluşturulur). Bu gruplar güncelleştirilemez veya kaldırılamaz.

  • LastDirSyncTime. Grubun en son eşitlendiği tarih ve saat.

  • ManagedBy. Grubun sahibi.

  • Objectıd. Grubun benzersiz nesne kimliği.

  • Proxy Adresleri. Bu grupla ilişkili ara sunucu adresleri (yalnızca posta etkin gruplar için).

  • Validationstatus. Grupta hata olup olmadığı.