新增和管理安全組

Azure DevOps 服務

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

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

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

Note

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

Prerequisites

Category	Requirements
Permissions	專案集合系統管理員群組的成員。組織擁有者會自動成為此群組的成員。如需令牌的詳細資訊，請參閱安全性命名空間和許可權參考。
Tools	Azure DevOps CLI 擴充功能。使用 `az login`登入。

安全組命令

Command	Description
`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`	從安全組移除成員。

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

detect：自動偵測機構。接受的值：false、true。默認值為 true。
org：Azure DevOps 組織的網址。您可以使用 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}]

可選參數

說明：新安全群組的說明。
email-id：使用該電子郵件地址作為Microsoft Entra支援供應商現有群組的參考，建立新群組。若缺少姓名或 來源識別 碼，則必須如此。
群組：一個逗號分隔的描述詞清單，用來參考你希望新建立的群組加入的群組。
名稱：新安全組織名稱。若缺少 來源識別 碼或 電子郵件識別 碼，則必須如此。
origin-id：使用 OriginID 作為 Microsoft Entra 支援提供者現有群組的參考，建立新群組。若缺少姓名或 電子郵件識別碼 ，則需此項。
專案：該群組應成立的專案名稱或 ID。
範圍：在專案或組織層級建立小組。被接受的值是組織和專案（預設值）。

Example

以下指令在 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]

Parameters

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

Example

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

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。

Example

以下指令列出 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

Parameters

id：必要。安全組描述元。

Example

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

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]

Parameters

id：必要。安全組描述元。
描述：選擇性。安全組的新描述。若姓名未標明，則必須填寫。
name：選擇性。安全組的新名稱。若缺少描述，則必須如此。

Example

下列命令會使用指定的描述元變更安全組的名稱，並以 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

Parameters

群組ID：必須。要加入成員之群組的描述元。
會員編號：必須。要新增之使用者群組或電子郵件位址的描述項。

Example

下列命令會將使用者 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}]

Parameters

id：必要。需要其成員資格詳細數據的安全組描述元或用戶電子郵件位址。
關係：可選。取得該團體的成員資訊。 公認的值為成員與成員。

Examples

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

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]

Parameters

群組ID：必須。需要從中移除成員之群組的描述元。
會員編號：必須。要移除之使用者群組或電子郵件位址的描述項。
是：選擇性。請勿提示確認。

Example

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

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

意見反應

此頁面對您有幫助嗎？

上次更新時間： 2026-05-08

新增和管理安全組

Prerequisites

安全組命令

建立安全組

可選參數

Example

刪除安全組

Parameters

Example

列出安全組

可選參數

Example

顯示安全組詳細數據

Parameters

Example

更新安全組

Parameters

Example

將成員新增至群組

Parameters

Example

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

Parameters

Examples

從群組中移除成員

Parameters

Example

相關內容

意見反應

其他資源