Get-MsolGroup
Azure Active Directory'den grupları alır.
Sözdizimi
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 sonuclara kadar tüm grup kümesini 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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-GroupType
Alınacak grupların türünü belirtir. Geçerli değerler Security, MailEnabledSecurity ve DistributionList değerleridir.
Tür: | GroupType |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-HasErrorsOnly
Bu cmdlet'in yalnızca doğrulama hataları olan grupları döndürdüğünü gösterir.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-HasLicenseErrorsOnly
Bu cmdlet'in yalnızca lisans hataları olan güvenlik gruplarını döndürip döndürmediğini belirtir.
Tür: | Boolean |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-MaxResults
Bu cmdlet'in döndürdüğü en fazla sonuç sayısını belirtir. Varsayılan değer 250'dir.
Tür: | Int32 |
Position: | Named |
Default value: | 250 |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ObjectId
Alınacak grubun benzersiz nesne kimliğini belirtir.
Tür: | Guid |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-SearchString
Bir dize belirtir. Bu cmdlet, bu dizeyle başlayan görünen ada sahip güvenlik gruplarını döndürür.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | Guid |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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.
Tür: | Guid |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UserPrincipalName
Kullanıcının 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.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Ara Sunucu Adresleri. Bu grupla ilişkilendirilmiş ara sunucu adresleri (yalnızca posta etkin gruplar için).
Validationstatus. Grupta hata olup olmadığı.
İlişkili Bağlantılar
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin