新增和管理安全組

發行項
12/20/2024

Azure DevOps Services

安全組是用來管理許可權和存取權，如開始使用許可權、存取權和安全組中所述，。例如，參與者群組或專案管理員群組的成員會獲指派這些群組所允許的許可權。

Azure DevOps 已使用預設安全組預先設定。您可以使用 az devops 安全組命令，為組織或專案新增和管理安全組。使用此命令來執行下列工作。

建立新的安全組
檢視安全組和安全組詳細數據
更新或刪除安全組
管理群組和使用者的安全組成員資格

注意

本文僅適用於 Azure DevOps Services。針對 Azure DevOps Server，您可以使用 TFSSecurity 命令來管理安全組。

先決條件

許可權：成為安全組專案集合系統管理員的成員。如需令牌的詳細資訊，請參閱安全性命名空間和許可權參考。
Tools：如開始使用 Azure DevOps CLI 中所述，安裝 Azure DevOps CLI 擴充功能。使用 az login登入 Azure DevOps。

安全組命令

命令	描述
`az devops security group create`	建立 Azure DevOps 安全組。
`az devops security group delete`	刪除 Azure DevOps 安全組。
`az devops security group list`	列出專案或組織中的所有群組。
`az devops security group show`	顯示群組詳細數據。
`az devops security group update`	更新安全組的名稱和描述。
`az devops security group membership add`	將成員新增至安全組。
`az devops security group membership list`	列出群組或用戶的成員資格。
`az devops security group membership remove`	從安全組移除成員。

下列參數是所有命令的選擇性參數，但未列於本文中提供的範例中。

偵測：自動偵測組織。接受的值：false、true。默認值為 true。
組織：Azure DevOps 組織 URL。您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：--org https://dev.azure.com/MyOrganizationName/。

建立安全組

您可以使用 az devops 安全組 create 命令建立安全組。

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

選擇性參數

描述：新安全組的描述。
電子郵件標識碼：使用電子郵件位址建立新的群組，作為來自 Microsoft Entra 支援提供者的現有群組參考。如果遺漏名稱或 原始標識碼，則為必要專案。
群組：以逗號分隔的描述元清單，參考您想要新建立的群組加入群組。
名稱：新安全組的名稱。如果遺漏 原始標識碼 或 電子郵件標識碼，則為必要專案。
origin-id：使用 OriginID 建立新的群組，作為從 Microsoft Entra 支援提供者的現有群組參考。如果遺漏電子郵件標識碼名稱或，則為必要專案。
專案：應該在其中建立群組的專案名稱或標識符。
範圍：在專案或組織層級建立群組。接受的值是組織和專案（預設值）。

例

下列命令會在專案 MyFirstProject 中建立 帳戶管理 安全組，並以數據表格式顯示結果。

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

刪除安全組

您可以使用 az devops 安全組 delete 命令來刪除安全組。

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

參數

識別碼：必要。安全組描述元。若要取得描述元，請使用 az devops 安全組清單命令。
是：選擇性。請勿提示確認。

例

下列命令會刪除具有指定描述元的安全組，而且不會提示確認。

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

列出安全組

您可以使用 az devops 安全組清單命令，列出專案或組織中所有安全組。

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

選擇性參數

接續令牌：如果在單一頁面中傳回更多無法傳回的結果，結果集將會包含接續令牌，以便擷取下一組結果。
專案：列出特定專案的群組。
範圍：列出專案或組織層級的群組。接受的值是組織和專案（預設值）。
主旨類型：以逗號分隔的使用者主旨子類型清單，以減少擷取的結果。您可以提供描述元的初始部分（在點之前）做為篩選，例如 vssgp，aadgp。

例

下列命令會列出 MyFirstProject中所有安全組的名稱和描述項，並以數據表格式顯示結果。

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

顯示安全組詳細數據

您可以使用 az devops 安全組 show 命令來顯示安全組的詳細數據。

az devops security group show --id

參數

識別碼：必要。安全組描述元。

例

下列命令顯示數據表格式 專案有效使用者 安全組的詳細數據。

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.

更新安全組

您可以使用 az devops 安全組 update 命令更新安全組的名稱和描述。

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

參數

識別碼：必要。安全組描述元。
描述：選擇性。安全組的新描述。如果遺漏名稱，則為必要專案。
名稱：選擇性。安全組的新名稱。如果遺漏描述，則為必要專案。

例

下列命令會使用指定的描述元變更安全組的名稱，並以 YAML 格式顯示結果。

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

將成員新增至群組

您可以使用 az devops 安全組成員資格 add 命令，將成員新增至安全組。

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

參數

group-id：必要。要加入成員之群組的描述元。
成員標識碼：必要。要新增之使用者群組或電子郵件位址的描述項。

例

下列命令會將使用者 contoso@contoso.com 新增至指定的安全組，並以數據表格式顯示結果。

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

列出群組或用戶的成員資格

您可以使用 az devops 安全組成員資格清單命令，列出群組或使用者的成員資格清單。

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

參數

識別碼：必要。需要其成員資格詳細數據的安全組描述元或用戶電子郵件位址。
關聯性：選擇性。取得群組或成員資訊成員。接受的值成員，成員。

例子

下列命令會列出指定安全組的成員，並以數據表格式顯示結果。

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 專案的 EMail 小組成員。

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

從群組中移除成員

您可以使用 az devops 安全組成員資格 remove 命令，從安全組中移除成員。

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

參數

group-id：必要。需要從中移除成員之群組的描述元。
成員標識碼：必要。要移除之使用者群組或電子郵件位址的描述項。
是：選擇性。請勿提示確認。

例

下列命令會從指定的安全組中移除使用者 contoso@contoso.com，而不會提示確認。

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

共用方式為

新增和管理安全組

先決條件

安全組命令

建立安全組

選擇性參數

例

刪除安全組

參數

例

列出安全組

選擇性參數

例

顯示安全組詳細數據

參數

例

更新安全組

參數

例

將成員新增至群組

參數

例

列出群組或用戶的成員資格

參數

例子

從群組中移除成員

參數

例

意見反應

其他資源

共用方式為

新增和管理安全組

先決條件

安全組命令

建立安全組

選擇性參數

例

刪除安全組

參數

例

列出安全組

選擇性參數

例

顯示安全組詳細數據

參數

例

更新安全組

參數

例

將成員新增至群組

參數

例

列出群組或用戶的成員資格

參數

例子

從群組中移除成員

參數

例

相關文章

意見反應

其他資源