次の方法で共有

Git アクセス許可コマンド

  • [アーティクル]

Azure DevOps Services の |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

tf git permission コマンドは、ユーザー アクセス制御リスト (ACL) を変更し、Git リポジトリ内の Git リポジトリまたはブランチの承認設定を表示します。

前提 条件

  • アクセス許可を表示するには、要求する情報の種類の成果物を表示できます。プロジェクト コレクションのコレクション レベルの情報 の表示、プロジェクトのプロジェクト レベルの情報 の表示 、ブランチのアクセス許可を表示している場合はリポジトリとブランチの読み取り の 。

  • アクセス許可を管理するには、必要な成果物のアクセス許可 を管理する必要があります。

詳細については、「既定の Git アクセス許可 」を参照してください。

構文

tf git permission [/allow:(* |perm1[,perm2,...]] 
                  [/deny:(* |perm1[,perm2,...])]
                  [/remove:(* |perm1[,perm2,...])]
                  [/user:username1[,username2,...]]
                  [/group:groupname1[,groupname2,...]]
                  /collection:TeamProjectCollectionUrl
                  [/teamproject:TeamProjectIdentifier]
                  [/repository:RepositoryIdentifier]
                  [/branch:BranchName]
                  [/login:username,[password]]

パラメーター

パラメーター 形容
/allow:(* |<perm1>[,<perm2>,...]) 許可するアクセス許可。
/deny:(* |<perm1>[,<perm2>,...]) 拒否するアクセス許可。
/remove:(* |<perm1>[,<perm2>,...]) 削除するアクセス許可。未設定と呼ばれることもあります。 同じ呼び出しで、/allow、/deny、および /remove の 3 つすべてを使用できます。 許可、拒否、および削除の設定の対話方法の詳細については、「アクセス許可の設定を参照してください。
/user:<username1>[,<username2>,...] アクセス許可を許可、拒否、または削除するユーザー。 少なくとも 1 つのユーザーまたはグループを指定する必要があります。
/group:<groupname1>[,<groupname2>,...] アクセス許可を許可、拒否、または削除するグループ。 少なくとも 1 つのユーザーまたはグループを指定する必要があります。 グループと個人を一緒に使用できます。
/collection:<TeamProjectCollectionUrl> 表示または変更する権限を含むプロジェクト コレクションの URL を指定します。 例: http://myserver:8080/tfs/DefaultCollection または https://fabrikam-fiber.visualstudio.com。 このパラメーターは必須です。
/teamproject:<TeamProjectIdentifier> 表示または変更する権限を含むプロジェクトの名前を指定します。
/repository:<RepositoryIdentifier> 表示または変更するアクセス許可を含むリポジトリの名前を指定します。
/branch:<BranchName> 表示または変更するアクセス許可を含むブランチの名前を指定します。 /branchを指定する場合は、/repositoryも指定する必要があります。
/login:<username>[,<password>] コマンドを実行するユーザー アカウントを指定します。 「Team Foundation バージョン管理コマンド使用する」を参照してください。

コマンドで管理できるアクセス許可の一覧については、 Git リポジトリのアクセス許可名前空間を参照してください。

例

手記

次の例は、読みやすくするために複数行に分割されています。 それらをコピーしてコマンド ラインに貼り付けて実行するには、まずそれらをコピーしてメモ帳または別のツールに貼り付け、コマンドが 1 行に含まれるように編集します。

コレクション レベルのアクセス許可を表示する

次の例では、fabrikam-fiber コレクションのアクセス許可を一覧表示します。

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

プロジェクト レベルのアクセス許可を表示する

次の例では、fabrikam-fiber コレクション内にある FabrikamFiber プロジェクトのプロジェクト レベルの権限を一覧表示します。

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /teamproject:FabrikamFiber
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

リポジトリ レベルのアクセス許可を表示する

次の例では、FabrikamFiber プロジェクトにある FabrikamFiber リポジトリのプロジェクト レベルのアクセス許可を一覧表示します。

tf git permission /collection:https://dev.azure.com/fabrikam-fiber 
                  /teamproject:FabrikamFiber 
                  /repository:FabrikamFiber 
                  /login:FabrikamUser@hotmail.com,FabrikamPassword

ブランチ フォルダーのコマンドを要求する

次の例は、次の制約を適用するブランチ ポリシーを作成する方法を示しています。

  • リポジトリ ルートに存在できるのは main だけです。
  • すべてのユーザーは、features/ フォルダーと users/ フォルダーの下にブランチを作成できます。
  • 管理者は、releases/ フォルダーの下にブランチを作成できます。

この例では、次のコレクション、プロジェクト、リポジトリを使用します。

  • /collection: https://fabrikam-fiber.visualstudio.com
  • /teamproject: FabrikamProject
  • /repository FabrikamRepo

まず、プロジェクトの共同作成者のリポジトリ ルートで CreateBranch アクセス許可をブロックします。

tf git permission /deny:CreateBranch 
                  /group:[FabrikamProject]\Contributors 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo

次に、共同作成者が features と usersの下にブランチを作成できるようにします。

tf git permission /allow:CreateBranch 
                  /group:[FabrikamProject]\Contributors 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:features

tf git permission /allow:CreateBranch 
                  /group:[FabrikamProject]\Contributors 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:users

管理者が releasesの下にブランチを作成できるようにします。

tf git permission /allow:CreateBranch 
                  /group:"[FabrikamProject]\Project Administrators" 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:releases

最後に、管理者が誤って削除された場合に備えて、mainというブランチを作成できるようにします。

tf git permission /allow:CreateBranch 
                  /group:"[FabrikamProject]\Project Administrators" 
                  /collection:https://dev.azure.com/fabrikam-fiber/ 
                  /teamproject:FabrikamProject 
                  /repository:FabrikamRepo 
                  /branch:main
  • git view コマンド を する