次の方法で共有

セキュリティ グループの追加と管理

  • [アーティクル]

Azure DevOps Services の

セキュリティ グループは、「アクセス許可、アクセス、セキュリティ グループの概要」の説明に従って、アクセス許可とアクセスを管理するために使用されます。 たとえば、共同作成者グループまたはプロジェクト管理者グループのメンバーには、それらのグループに対して許可されているアクセス許可が割り当てられます。

Azure DevOps は、既定のセキュリティ グループで事前に構成されています。 az devops セキュリティ グループ コマンドを して、組織またはプロジェクトのセキュリティ グループを追加および管理できます。 このコマンドを使用して、次のタスクを実行します。

  • 新しいセキュリティ グループを作成する
  • セキュリティ グループとセキュリティ グループの詳細を表示する
  • セキュリティ グループを更新または削除する
  • グループとユーザーのセキュリティ グループ メンバーシップを管理する

手記

この記事は、Azure DevOps Services にのみ適用されます。 Azure DevOps Server の場合は、TFSSecurity コマンドを使用してセキュリティ グループを管理できます。

前提 条件

  • 権限: プロジェクト コレクション管理者 セキュリティ グループのメンバーになります。 トークンの詳細については、「Security 名前空間とアクセス許可のリファレンス」を参照してください。
  • ツール: 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 security group create コマンド 使用して、セキュリティ グループを作成できます。

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

省略可能なパラメーター

  • 説明: 新しいセキュリティ グループの説明。
  • email-id: Microsoft Entra でサポートされているプロバイダーの既存のグループへの参照として、電子メール アドレスを使用して新しいグループを作成します。 名前 または origin-id が見つからない場合に必要です。
  • グループ: 新しく作成したグループを結合するグループを参照する記述子のコンマ区切りのリスト。
  • 名前: 新しいセキュリティ グループの名前。 origin-id または email-id 存在しない場合に必要です。
  • origin-id: Microsoft Entra でサポートされているプロバイダーの既存のグループへの参照として OriginID を使用して新しいグループを作成します。 名前 または の電子メール ID が見つからない場合に必要です。
  • プロジェクト: グループを作成するプロジェクトの名前または ID。
  • スコープ: プロジェクトまたは組織レベルでグループを作成します。 指定できる値は、組織 とプロジェクト です (既定値)。

例

次のコマンドは、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 security group delete コマンドを使用して、セキュリティ グループを削除できます。

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

パラメーター

  • ID: 必須。 セキュリティ グループ記述子。 記述子を取得するには、az devops セキュリティ グループ リスト コマンド 使用します。
  • はい: 省略可能。 確認を求めないでください。

例

次のコマンドは、指定された記述子を持つセキュリティ グループを削除し、確認を求めるメッセージを表示しません。

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

セキュリティ グループを一覧表示する

az devops security group list コマンドを使用して、プロジェクトまたは組織内のすべてのセキュリティ グループを一覧表示できます。

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

省略可能なパラメーター

  • 継続トークンの: 1 つのページで返されない結果が増えた場合、結果セットには、次の結果セットを取得するための継続トークンが含まれます。
  • プロジェクト: 特定のプロジェクトのグループを一覧表示します。
  • スコープ: プロジェクトまたは組織レベルでグループを一覧表示します。 指定できる値は、組織 とプロジェクト です (既定値)。
  • サブジェクトの種類の: 取得した結果を減らすためのユーザーサブジェクト サブタイプのコンマ区切りのリスト。 記述子の最初の部分 (ドットの前) をフィルター (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 security group show コマンドを使用して、セキュリティ グループの詳細を表示できます。

az devops security group show --id

パラメーター

  • ID: 必須。 セキュリティ グループ記述子。

例

次のコマンドは、Project Valid Users セキュリティ グループの詳細を表形式で示しています。

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 セキュリティ グループの更新 コマンドを使用して、セキュリティ グループの名前と説明を更新できます。

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

パラメーター

  • ID: 必須。 セキュリティ グループ記述子。
  • 説明: 省略可能。 セキュリティ グループの新しい説明。 名前 が見つからない場合は必須です。
  • 名前: 省略可能。 セキュリティ グループの新しい名前。 説明 が見つからない場合は必須です。

例

次のコマンドは、指定された記述子を持つセキュリティ グループの名前を変更し、結果を 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 security group membership add コマンドを使用して、を使用してセキュリティ グループにメンバーを追加できます。

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

パラメーター

  • group-id: 必須。 メンバーを追加するグループの記述子。
  • メンバー 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 security group membership list コマンドを使用して、グループまたはユーザーのメンバーシップを一覧表示できます。

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

パラメーター

  • ID: 必須。 メンバーシップの詳細が必要なセキュリティ グループ記述子またはユーザーの電子メール アドレス。
  • リレーションシップ: 省略可能。 グループ 情報を または メンバー メンバーを取得します。 受け入れられる値は、 のメンバーとメンバー されます。

例

次のコマンドは、指定したセキュリティ グループのメンバーを一覧表示し、結果を表形式で表示します。

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 セキュリティ グループ メンバーシップの削除コマンドを使用して、セキュリティ グループからメンバー 削除できます。

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

パラメーター

  • group-id: 必須。 メンバーを削除する必要があるグループの記述子。
  • メンバー ID: 必須。 削除するユーザーのグループまたは電子メール アドレスの記述子。
  • はい: 省略可能。 確認を求めないでください。

例

次のコマンドは、確認を求めずに、指定したセキュリティ グループからユーザー contoso@contoso.com を削除します。

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