Güvenlik grupları ekleme ve yönetme

  • Makale

Azure DevOps Services

Güvenlik grupları, İzinleri, erişimi ve güvenlik gruplarını kullanmaya başlama bölümünde açıklandığı gibi izinleri ve erişimi yönetmek için kullanılır. Örneğin, Katkıda Bulunanlar grubunun veya Project Yönetici istrators grubunun üyelerine bu gruplar için izin verilen izinler atanır.

Azure DevOps, varsayılan güvenlik gruplarıyla önceden yapılandırılmıştır. Az devops güvenlik grubu komutları ile kuruluşunuz veya projeniz için güvenlik grupları ekleyebilir ve yönetebilirsiniz. Aşağıdaki görevleri gerçekleştirmek için bu komutu kullanın.

  • Yeni güvenlik grubu oluşturma
  • Güvenlik gruplarını ve güvenlik grubu ayrıntılarını görüntüleme
  • Güvenlik grubunu güncelleştirme veya silme
  • Gruplar ve kullanıcılar için güvenlik grubu üyeliklerini yönetme

Not

Bu makale yalnızca Azure DevOps Services için geçerlidir. Azure DevOps Server için TFSGüvenlik komutunu kullanarak güvenlik gruplarını yönetebilirsiniz.

Önkoşullar

  • Güvenlik grupları eklemek ve yönetmek için Proje Koleksiyonu Yönetici istrators güvenlik grubunun üyesi olmanız gerekir.
  • Azure DevOps CLI'yi kullanmaya başlama bölümünde açıklandığı gibi Azure DevOps CLI uzantısını yüklemiş olmanız gerekir.
  • kullanarak az loginAzure DevOps'ta oturum açın.
  • Bu makaledeki örnekler için varsayılan kuruluşu şu şekilde ayarlayın: az devops configure --defaults organization=YourOrganizationURL.

Güvenlik grubu komutları

Komut Açıklama
az devops security group create Bir Azure DevOps güvenlik grubu oluşturun.
az devops security group delete Azure DevOps güvenlik grubunu silin.
az devops security group list Proje veya kuruluştaki tüm grupları listeleme.
az devops security group show Grup ayrıntılarını göster.
az devops security group update Güvenlik grubunun adını ve açıklamasını güncelleştirin.
az devops security group membership add Güvenlik grubuna üye ekleme.
az devops security group membership list Bir grup veya kullanıcının üyeliklerini listeleme.
az devops security group membership remove Güvenlik grubundan üye kaldırma.

Aşağıdaki parametreler tüm komutlar için isteğe bağlıdır ve bu makalede sağlanan örneklerde listelenmez.

  • detect: Kuruluşu otomatik olarak algılayın. Kabul edilen değerler: false, true. Varsayılanı doğrudur
  • kuruluş: Azure DevOps kuruluş URL'si. az devops configure -d organization=ORG_URL kullanarak varsayılan kuruluşu yapılandırabilirsiniz. Varsayılan olarak yapılandırılmadıysa veya git yapılandırması aracılığıyla alınmadıysa gereklidir. Örnek: --org https://dev.azure.com/MyOrganizationName/.

Güvenlik grubu oluşturma

az devops security group create komutuyla bir güvenlik grubu oluşturabilirsiniz .

az devops security group create [--description]
                                [--email-id]
                                [--groups]
                                [--name]
                                [--origin-id]
                                [--project]
                                [--scope {organization, project}]

İsteğe bağlı parametreler

  • description: Yeni güvenlik grubunun açıklaması.
  • email-id: Microsoft Entra destekli sağlayıcıdan var olan bir gruba başvuru olarak e-posta adresini kullanarak yeni grup oluşturun. Ad veya kaynak kimliği eksikse gereklidir.
  • gruplar: Yeni oluşturulan grubun katılmasını istediğiniz gruplara başvuran tanımlayıcıların virgülle ayrılmış listesi.
  • name: Yeni güvenlik grubunun adı. Kaynak kimliği veya e-posta kimliği eksikse gereklidir.
  • origin-id: Microsoft Entra destekli sağlayıcıdan var olan bir gruba başvuru olarak OriginID kullanarak yeni grup oluşturun. Ad veya e-posta kimliği eksikse gereklidir.
  • project: Grubun oluşturulması gereken projenin adı veya kimliği.
  • kapsam: Proje veya kuruluş düzeyinde grup oluşturun. Kabul edilen değerler kuruluş ve projedir (varsayılan).

Örnek

Aşağıdaki komut, MyFirstProject projesinde Hesap Yönetimi güvenlik grubunu oluşturur ve sonucu tablo biçiminde gösterir.

az devops security group create --name "Account Management" --project MyFirstProject --description "Management team focused on creating and maintaining customer services" --output table

Name                                 Description
-----------------------------------  ---------------------------------------------------------------------
[MyFirstProject]\Account Management  Management team focused on creating and maintaining customer services

Güvenlik grubunu silme

Az devops security group delete komutuyla bir güvenlik grubunu silebilirsiniz .

az devops security group delete --id
                                [--yes]

Parametreler

  • kimlik: Gerekli. Güvenlik grubu tanımlayıcısı. Tanımlayıcı almak için az devops security group list komutunu kullanın.
  • Evet: İsteğe bağlı. Onay istemde bulunmayın.

Örnek

Aşağıdaki komut, belirtilen tanımlayıcıya sahip güvenlik grubunu siler ve onay istemez.

az devops security group delete --id vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMC0wLTAtMC0x --yes

Güvenlik gruplarını listeleme

Az devops security group list komutuyla bir projedeki veya kuruluştaki tüm güvenlik gruplarını listeleyebilirsiniz .

az devops security group list [--continuation-token]
                              [--project]
                              [--scope {organization, project}]
                              [--subject-types]

İsteğe bağlı parametreler

  • continuation-token: Tek bir sayfada döndürülmeyecek daha fazla sonuç varsa, sonuç kümesi sonraki sonuç kümesinin alınması için bir devamlılık belirteci içerir.
  • project: Belirli bir proje için grupları listeleyin.
  • kapsam: Grupları proje veya kuruluş düzeyinde listeleyin. Kabul edilen değerler kuruluş ve projedir (varsayılan).
  • konu türleri: Alınan sonuçları azaltmak için kullanıcı konusu alt türlerinin virgülle ayrılmış listesi. Tanımlayıcının ilk bölümünü (noktadan önce) filtre olarak verebilirsiniz; örneğin, vssgp,aadgp.

Örnek

Aşağıdaki komut, MyFirstProject içindeki tüm güvenlik gruplarının adını ve tanımlayıcısını listeler ve sonuçları tablo biçiminde gösterir.

az devops security group list --project MyFirstProject --output table

Name                                     Descriptor
---------------------------------------  --------------------------------------------------------------------------------------------------------------------------------------------------
[MyFirstProject]\Contributors            vssgp.Uy0xLTktMTU1MTM3NDI0NS0zMjgyMTE0Mzg4LTcyMDc3NjM2LTI5MzA1OTM5MTEtMTI2ODYyOTM0My0xLTE0MzUxMDc1MzctMzkwMDAzNTkwNS0zMTk5MDU1NDY1LTM4MDE2ODQ3MzM
[MyFirstProject]\Project Valid Users     vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMC0wLTAtMC0z
[MyFirstProject]\Account Management      vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMS0zNDU1MDI4NTE4LTI5Nzg5OTAxNTYtMjI4OTU2NzYyOS0xOTM2NDU3NTYw
[MyFirstProject]\Project Team            vssgp.Uy0xLTktMTU1MTM3NDI0NS0zMjgyMTE0Mzg4LTcyMDc3NjM2LTI5MzA1OTM5MTEtMTI2ODYyOTM0My0xLTM0OTQwNjM0ODktMjg4NDE3MTA4Mi0yMjkxMTIwNTYwLTM3NDc2NDkyNA
[MyFirstProject]\Readers                 vssgp.Uy0xLTktMTU1MTM3NDI0NS0zMjgyMTE0Mzg4LTcyMDc3NjM2LTI5MzA1OTM5MTEtMTI2ODYyOTM0My0xLTQ0MzQzMTA1My0yMTcyODUzNTc2LTI1MjY0NzgwNjMtMzY1NjU0NjczNQ
[MyFirstProject]\Account Administrators  vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMS02NTAxNzIxNjctMzk4MTU5MTEwNC0zMjE1MTIzNjI0LTEyMTMyOTQwNQ
[MyFirstProject]\Project Administrators  vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMC0wLTAtMC0x
[MyFirstProject]\Build Administrators    vssgp.Uy0xLTktMTU1MTM3NDI0NS0zMjgyMTE0Mzg4LTcyMDc3NjM2LTI5MzA1OTM5MTEtMTI2ODYyOTM0My0xLTI0MDEzNTE5NjItMzM2NTg2MzA5LTI2Mzg2ODkzMDktMzk5NTQ3OTU3MQ

Güvenlik grubu ayrıntılarını göster

az devops security group show komutuyla bir güvenlik grubunun ayrıntılarını gösterebilirsiniz .

az devops security group show --id

Parametreler

  • kimlik: Gerekli. Güvenlik grubu tanımlayıcısı.

Örnek

Aşağıdaki komut, Project Valid Users güvenlik grubunun ayrıntılarını tablo biçiminde gösterir.

az devops security group show --id vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMC0wLTAtMC0z --output table

Name                                  Description
------------------------------------  ------------------------------------------------------
[MyFirstProject]\Project Valid Users  Members of this group have access to the team project.

Güvenlik grubunu güncelleştirme

Az devops security group update komutuyla bir güvenlik grubunun adını ve açıklamasını güncelleştirebilirsiniz .

az devops security group update --id
                                [--description]
                                [--name]

Parametreler

  • kimlik: Gerekli. Güvenlik grubu tanımlayıcısı.
  • description: İsteğe bağlı. Güvenlik grubu için yeni açıklama. Ad eksikse gereklidir.
  • name: İsteğe bağlı. Güvenlik grubunun yeni adı. Açıklama eksikse gereklidir.

Örnek

Aşağıdaki komut, güvenlik grubunun adını belirtilen tanımlayıcıyla değiştirir ve sonucu YAML biçiminde gösterir.

az devops security group update --id vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMS0zNDU1MDI4NTE4LTI5Nzg5OTAxNTYtMjI4OTU2NzYyOS0xOTM2NDU3NTYw --name "Management Team" --output yaml

description: Management team focused on creating and maintaining customer services
descriptor: vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMS0zNDU1MDI4NTE4LTI5Nzg5OTAxNTYtMjI4OTU2NzYyOS0xOTM2NDU3NTYw
displayName: Management Team
domain: vstfs:///Classification/TeamProject/5417a1c3-4b04-44d1-aead-50774b9dbf5f
isCrossProject: null
isDeleted: null
isGlobalScope: null
isRestrictedVisible: null
legacyDescriptor: null
localScopeId: null
mailAddress: null
origin: vsts
originId: 8fe47a49-bfab-4356-9a85-90c5e62110be
principalName: '[MyFirstProject]\Management Team'
scopeId: null
scopeName: null
scopeType: null
securingHostId: null
specialType: null
subjectKind: group
url: https://vssps.dev.azure.com/fabrikam/_apis/Graph/Groups/vssgp.Uy0xLTktMTU1MTM3NDI0NS0xODI5NDgwMzA1LTEzNjM2MTczNTEtMjI0NzE1OTUyMC03ODEzNDk2MjItMS0zNDU1MDI4NTE4LTI5Nzg5OTAxNTYtMjI4OTU2NzYyOS0xOTM2NDU3NTYw

Gruba üye ekleme

az devops security group membership add komutuyla bir güvenlik grubuna üye ekleyebilirsiniz .

az devops security group membership add --group-id
                                        --member-id

Parametreler

  • group-id: Gerekli. Üyenin eklendiği grubun tanımlayıcısı.
  • member-id: Gerekli. Eklenecek kullanıcının grup veya e-posta adresinin tanımlayıcısı.

Örnek

Aşağıdaki komut kullanıcıyı contoso@contoso.com belirtilen güvenlik grubuna ekler ve sonuçları tablo biçiminde gösterir.

az devops security group membership add --group-id vssgp.Uy0xLTktMTU1MTM3NDI0NS0yMjc3MTY5NTAtOTkzNjA1MTg2LTI1ODQxNTkyOTktMjYzMDUyNzA2OC0xLTQxNDY0Mzc4MzktMzgxMDM2MDM5MS0yNjE0MjU5MzI3LTI5MjI2MTc3OTA --member-id contoso@contoso.com --output table

Name                                 Type    Email
-----------------------------------  ------  -------------------
[MyFirstProject]\Account Management  group
contoso@contoso.com                  user    contoso@contoso.com

Grup veya kullanıcı için üyelikleri listeleme

Az devops security group membership list komutuyla bir grup veya kullanıcının üyeliklerini listeleyebilirsiniz .

az devops security group membership list --id
                                         [--relationship {memberof, members}]

Parametreler

  • kimlik: Gerekli. Üyelik ayrıntıları gereken güvenlik grubu tanımlayıcısı veya kullanıcı e-posta adresi.
  • ilişki: İsteğe bağlı. Grubun üyesi veya üye bilgilerini alın. Kabul edilen değerler üye ve üyelerdir.

Örnekler

Aşağıdaki komut, belirtilen güvenlik grubunun üyelerini listeler ve sonuçları tablo biçiminde gösterir.

az devops security group membership list --id vssgp.Uy0xLTktMTU1MTM3NDI0NS0yMjc3MTY5NTAtOTkzNjA1MTg2LTI1ODQxNTkyOTktMjYzMDUyNzA2OC0xLTQxNDY0Mzc4MzktMzgxMDM2MDM5MS0yNjE0MjU5MzI3LTI5MjI2MTc3OTA --output table

Name                 Type    Email                Descriptor
-------------------  ------  -------------------  ----------------------------------------------------
contoso@contoso.com  user    contoso@contoso.com  msa.NDMzMmNjOWYtYzY4Zi03YTNlLTk2ZTktYmYwM2U4NjgxOTRh

Fabrikam Fiber projesi için EMail ekibinin üyelerini listeleyen başka bir örnek aşağıda verilmiştir.

az devops security group membership list --id "[Fabrikam Fiber]\Email" --output table
Name               Type    Email                       Descriptor
-----------------  ------  --------------------------  ----------------------------------------------------
Christie Church    user    fabrikamfiber1@hotmail.com  msa.OThjODMzM2ItMmI4Ny03YTkwLThmZGItYWQwYmQ1YWE4MzJk
Raisa Pokrovskaya  user    fabrikamfiber5@hotmail.com  msa.ZmUwYjk5NmYtZTAyNS03NzBkLTgxNmYtMzk1NDQwYzViMzgw

Gruptan üye kaldırma

az devops security group membership remove komutuyla bir güvenlik grubundan üye kaldırabilirsiniz .

az devops security group membership remove --group-id
                                           --member-id
                                           [--yes]

Parametreler

  • group-id: Gerekli. Üyesinin kaldırılması gereken grubun tanımlayıcısı.
  • member-id: Gerekli. Kaldırılacak kullanıcının grup veya e-posta adresinin tanımlayıcısı.
  • Evet: İsteğe bağlı. Onay istemde bulunmayın.

Örnek

Aşağıdaki komut, onay istemeden kullanıcıyı contoso@contoso.com belirtilen güvenlik grubundan kaldırır.

az devops security group membership remove --group-id vssgp.Uy0xLTktMTU1MTM3NDI0NS0yMjc3MTY5NTAtOTkzNjA1MTg2LTI1ODQxNTkyOTktMjYzMDUyNzA2OC0xLTQxNDY0Mzc4MzktMzgxMDM2MDM5MS0yNjE0MjU5MzI3LTI5MjI2MTc3OTA --member-id contoso@contoso.com --yes