Festlegen von Git-Repositoryeinstellungen und -Richtlinien

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Es gibt verschiedene Möglichkeiten, Ihre Azure Repos Git-Repositorys mithilfe von Branch- und Repositoryeinstellungen und -Richtlinien anzupassen. In diesem Artikel werden Einstellungen und Richtlinien auf Repositoryebene erläutert.

• Repositoryeinstellungen und Richtlinien konfigurieren globale Optionen für alle Git-Repositorys für ein Projekt oder eine Organisation oder für einzelne Repositorys.

  In diesem Artikel werden serverseitige Repositoryeinstellungen und -richtlinien erläutert. Weitere Informationen zu clientseitigen Git-Einstellungen finden Sie unter Git-Einstellungen und -Einstellungen in Visual Studio.

• Verzweigungsrichtlinien umfassen verzweigte Steuerelemente.

  Verzweigungsrichtlinien umfassen Optionen wie die Anforderung eines Pull-Anforderungs, eines erfolgreichen Builds oder einer Codeüberprüfung, bevor Änderungen in eine Verzweigung zusammengeführt werden können. Weitere Informationen finden Sie unter Branch-Richtlinien und -Einstellungen.

• Repository- und Zweigsicherheitsberechtigungen steuern Benutzerzuweisungen.

  Diese Berechtigungen steuern, wer lese-, schreib-, pull-Anforderungen beiträgt und andere spezifische Aktionen ausführen kann. Weitere Informationen finden Sie unter Festlegen von Berechtigungen für ein Repository.

Hinweis

Das in diesem Artikel dokumentierte Feature erfordert TFS 2018 Update 2 oder höher.

Zusammenfassung aller Repository- und Zweigeinstellungen und -richtlinien

Sie können Einstellungen und Richtlinien für alle Repositorys in einem Projekt, für einzelne Repositorys und für Verzweigungen von Repositorys konfigurieren. Im Browser konfigurieren Sie alle diese Einstellungen und Richtlinien über Project-Einstellungen-Repositorys>.

Hinweis

Sie können mehrere Zweigeinstellungen und -richtlinien mit der Azure CLI mithilfe der Az-Repos-Richtlinie festlegen.

In den folgenden Tabellen werden die Einstellungen und Richtlinien zusammengefasst, die Sie für Git-Repositorys und -Zweigen aktivieren und konfigurieren können.

Alle Repositoryeinstellungen

In der folgenden Tabelle werden die Einstellungen zusammengefasst, die Sie für alle neuen Git-Repositorys in einem Projekt oder in einer Organisation aktivieren und konfigurieren können.

Einstellung

Standard

Beschreibung

---

Standardzweigname für neue Repositorys

Aus

Initialisieren Sie neue Repositorys mit dem angegebenen Standardzweignamen. Sie können den Standardzweig für ein bestimmtes Repository jederzeit ändern. Wenn Sie dieses Feature nicht aktivieren, initialisieren Repositorys mit einem Standardzweig namens main".

Zulassen, dass Benutzer Berechtigungen für ihre erstellten Zweigstellen verwalten können

Andererseits

Ermöglichen Sie Benutzern die Verwaltung von Berechtigungen für ihre erstellten Zweigstellen in allen neuen Repositorys.

Repositoryeinstellungen

In der folgenden Tabelle werden die Einstellungen zusammengefasst, die Sie für jedes einzelne Git-Repository aktivieren oder konfigurieren können.

Einstellung

Standard

Beschreibung

---

Gravatarbilder

Andererseits

Aktiviert oder deaktiviert die Verwendung von Gravatar-Bildern für Benutzer außerhalb Ihres Unternehmens. Diese Einstellung gilt für alle Repositorys im Projekt.

Forks

Andererseits

Ermöglichen Sie Benutzern das Erstellen von Forks aus dem Repository.

Commit-Erwähnungsverknüpfung

Andererseits

Erstellen Sie automatisch Links für Arbeitselemente, die in einem Commit-Kommentar erwähnt werden.

Commit-Erwähnung der Arbeitselementauflösung

Andererseits

Zulassen von Erwähnungen in Commit-Kommentaren zum Schließen von Arbeitselementen. Erfordert Azure DevOps Server Version 2020.1 oder höher.

Einstellungen für den Übergang von Arbeitselementen

Andererseits

Denken Sie daran, dass Benutzereinstellungen zum Abschließen von Arbeitselementen mit Pullanforderungen ausgeführt werden.

Berechtigungsverwaltung

Andererseits

Zulassen, dass Benutzer Berechtigungen für die von ihnen erstellten Verzweigungen verwalten können

Strenger Abstimmungsmodus

Andererseits

Aktivieren Sie den strikten Abstimmungsmodus für das Repository, das die Berechtigung zum Abstimmen auf Pullanfragen erfordert.

Repository deaktivieren

Andererseits

Deaktivieren Sie den Zugriff auf das Repository, einschließlich Builds und Pullanforderungen, aber halten Sie das Repository mit einer Warnung auffindbar.

Durchsuchbare Verzweigungen

Andererseits

Geben Sie bis zu fünf weitere Verzweigungen an, die an der Codesuche teilnehmen sollen, die standardmäßig nur auf den Standardzweig angewendet wird. Erfordert die installierte Codesuche-Erweiterung und aktiviert.

Repositoryrichtlinien oder -optionen

In der folgenden Tabelle werden die Richtlinien oder Optionen zusammengefasst, die Sie für alle oder einzelne Repositorys festlegen können. Richtliniensatz für alle Repositorys legen die Standardeinstellung für einzelne Repositorys fest, die zu einem späteren Zeitpunkt hinzugefügt wurden.

Richtlinie oder Option

Standard

Beschreibung

---

Commit-E-Mail-Überprüfung

Aus

Blockieren Sie Pushs mit einer Commit-Autor-E-Mail, die nicht mit den angegebenen Mustern übereinstimmt. Diese Einstellung erfordert Azure DevOps Server 2020.1 oder höher Version.

Dateipfadüberprüfung

Aus

Blockieren Sie Pushs aus der Einführung von Dateipfaden, die den angegebenen Mustern entsprechen. Diese Einstellung erfordert Azure DevOps Server 2020.1 oder höher Version.

Fallerzwingung

Aus

Vermeiden Sie Groß-/Kleinschreibungskonflikte, indem Sie Pushs blockieren, die den Namen von Dateien, Ordnern, Zweigen und Tags ändern.

Reservierte Namen

Aus

Blockieren Sie Pushs, die Dateien, Ordner oder Verzweigungsnamen einführen, die plattform reservierte Namen oder inkompatible Zeichen enthalten.

Maximale Pfadlänge

Aus

Blockieren Sie Pushs, die Pfade einführen, die die angegebene Länge überschreiten.

Maximale Dateigröße

Aus

Blockieren Sie Pushe, die neue oder aktualisierte Dateien enthalten, die größer als der ausgewählte Grenzwert sind.

Branchrichtlinien

In der folgenden Tabelle werden die Richtlinien zusammengefasst, die Sie definieren können, um einen Zweig anzupassen. Weitere Informationen zum Konfigurieren dieser Einstellungen finden Sie unter "Verbessern der Codequalität mit Zweigrichtlinien". Wenn Sie eine Richtlinie für eine Verzweigung festlegen, werden die folgenden Richtlinien automatisch erzwungen:

• Pullanforderungen sind erforderlich, um den Zweig zu aktualisieren.
• Der Zweig kann nicht gelöscht werden.

Richtlinie

Standard

Beschreibung

---

Erfordern einer Mindestanzahl von Prüfern

Aus

Erfordern Sie die Genehmigung von einer angegebenen Anzahl von Prüfern für Pullanforderungen.

Suchen nach verknüpften Arbeitselementen

Aus

Fördern Sie die Ablaufverfolgung, indem Sie nach verknüpften Arbeitselementen auf Pullanforderungen suchen.

Überprüfen der Kommentarauflösung

Aus

Überprüfen Sie, ob alle Kommentare auf Pullanforderungen aufgelöst wurden.

Einschränken von Zusammenführungstypen oder Erzwingen einer Zusammenführungsstrategie

Aus

Steuern Sie den Zweigverlauf, indem Sie die verfügbaren Seriendrucktypen einschränken, wenn Pullanforderungen abgeschlossen werden.

Buildüberprüfung

Aus

Fügen Sie einen oder mehrere Richtlinien hinzu, um Code zu überprüfen, indem Sie Änderungen an Pull-Anforderungsänderungen vorab zusammenführen, aktivieren oder deaktivieren.

Statusüberprüfungen oder
Erfordern einer Genehmigung von zusätzlichen oder externen Diensten

Aus

Hinzufügen, Aktivieren oder Deaktivieren einer oder mehrerer Richtlinien, um andere Dienste zu benötigen, um den erfolgreichen Status zu veröffentlichen, um Pullanforderungen abzuschließen.

Automatisch eingeschlossene Prüfer

Aus

Fügen Sie eine oder mehrere Richtlinien hinzu, um Codeprüfer automatisch einzuschließen, wenn Pullanforderungen bestimmte Codebereiche ändern.

Voraussetzungen

• Um Richtlinien zu konfigurieren, müssen Sie Mitglied der Sicherheitsgruppe "Projektadministratoren" sein oder über Berechtigungen auf Repositoryebene verfügen. Weitere Informationen finden Sie unter Festlegen von Git-Repositoryberechtigungen.
• Wenn Sie Az-Reposbefehle verwenden möchten, müssen Sie die Schritte in der Azure DevOps CLI ausführen.

• Um Richtlinien zu konfigurieren, müssen Sie Mitglied der Sicherheitsgruppe "Projektadministratoren" sein oder über Berechtigungen auf Repositoryebene verfügen. Weitere Informationen finden Sie unter Festlegen von Git-Repositoryberechtigungen.

Anzeigen und Bearbeiten von Einstellungen und Richtlinien

Sie können Einstellungen für alle Repositorys in einer Organisation oder einem Projekt oder für einzelne Repositorys konfigurieren. Sie können Richtlinien für alle Repositorys, für einzelne Repositorys oder für bestimmte Verzweigungen über Repositorys konfigurieren. Informationen zum Festlegen von Zweigrichtlinien finden Sie unter Branch-Richtlinien.

Hinweis

Es ist am besten, Repositoryeinstellungen auf Projektebene oder für einzelne Repositorys zu konfigurieren, aber nicht beide. Wenn Sie Einstellungen auf mehr als einer Ebene konfigurieren, honoriert das System die restriktivste Einstellung. Die Konfiguration von Einstellungen auf nur einer Ebene reduziert Verwirrung und Git-Leistungsprobleme.

Browser

Um Repositoryeinstellungen und -richtlinien über das Webportal zu konfigurieren, öffnen Sie Projekteinstellungen>Repositorys aus Ihrem Webbrowser.

1. Um Einstellungen oder Richtlinien für alle Git-Repositorys anzuzeigen oder zu ändern, öffnen Sie die Seite "Alle Repositorys ", und wählen Sie "Einstellungen " oder "Richtlinien" aus.

   

   Wenn Sie Einstellungen und Richtlinien für ein bestimmtes Repository konfigurieren möchten, wählen Sie die Registerkarte "Repository " aus, wählen Sie das Repository aus, und wählen Sie dann die Registerkarte "Einstellungen " oder " Richtlinien " aus.

   

2. Im folgenden Screenshot wird die Registerkarte "Einstellungen" ausgewählt. Sie können diese Einstellungen für alle Git-Repositorys oder für ein einzelnes Repository definieren.

   

3. Im folgenden Screenshot wird die Registerkarte "Richtlinien " ausgewählt. Sie können diese Richtlinien für alle Git-Repositorys oder für ein einzelnes Repository definieren.

   

1. Öffnen Sie im Webbrowser das Projekt, und wählen Sie Projekteinstellungen, Repositorys aus, und wählen Sie Ihr Repository aus.

   

2. Wenn Sie Repositoryeinstellungen anzeigen und konfigurieren möchten, wählen Sie "Optionen " oder " Richtlinien" aus.

   Der folgende Screenshot zeigt Optionen für alle Repositorys:

   

   Der folgende Screenshot zeigt Optionen für die Fabrikam-Repositorys:

   

1. Öffnen Sie im Webbrowser das Projekt, und wählen Sie das Zahnradsymbol, die Versionskontrolle und das Repository aus.

   

2. Wählen Sie Optionen aus, um Ihre Repositoryeinstellungen anzuzeigen und zu konfigurieren.

   

Erste Schritte mit der Azure DevOps-CLI

Sie können Azure DevOps CLI verwenden, um Respositories auflisten oder ein Repository anzuzeigen oder zu aktualisieren. Außerdem können Sie Richtliniendetails für einen Zweig oder Repository auflisten, anzeigen oder aktualisieren.

Listenrepositorys | Listen-Repositorydetails | Aktualisieren oder Umbenennen eines Repositorys
Repositoryrichtlinien | auflisten Listenrichtliniendetails | Aktualisieren der Respository-Richtlinie

Sie können Azure CLI verwenden, um Richtlinien für eine Verzweigung oder ein Repository oder für alle Repositorys in einem Projekt auflisten, anzeigen und aktualisieren.

Auflisten von Repositorys

Verwenden Sie die Az-Repos-Liste , um alle Repositorys für ein Projekt auflisten zu können.

az repos list [--detect {false, true}]
              [--org]
              [--project]
              [--subscription]

Parameter

Parameter	BESCHREIBUNG
detect	Die Organisation wird automatisch erkannt. Akzeptierte Werte: false, true.
org, organization	Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe az devops configure -d organization=<ORG_URL>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe az devops configure -d project=<NAME_OR_ID>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.

Beispiel

Der folgende Befehl gibt alle Git-Repositorys für die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"zurück.

az repos list --output table
ID                                    Name            Default Branch    Project
------------------------------------  --------------  ----------------  --------------
50a9df8e-5024-49d7-bf63-d3989139627e  Fabrikam Fiber  main              Fabrikam Fiber
ac228555-ea89-4881-9ace-dfa065baf7d3  Test 1-2-3      main              Fabrikam Fiber
0d58f562-4a10-495d-94d7-7ac61a22d7cc  Testing 1 2 3   main              Fabrikam Fiber
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO     main              Fabrikam Fiber

Listen-Repositorydetails

Verwenden Sie Az-Repos , um Informationen zu einem Repository auflisten oder sie in einem Webbrowser zu öffnen.

az repos show --repository
              [--detect {false, true}]
              [--open]
              [--org]
              [--project]
              [--subscription]

Parameter

Parameter	BESCHREIBUNG
repository	Name oder ID eines Repositorys.
detect	Die Organisation wird automatisch erkannt. Akzeptierte Werte: false, true.
open	Öffnen Sie die Repositoryseite im Webbrowser.
org, organization	Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe az devops configure -d organization=<ORG_URL>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe az devops configure -d project=<NAME_OR_ID>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.

Beispiel

Der folgende Befehl enthält die Details des contosoREPO für die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

Geben Sie für weitere Details den folgenden Befehl ein:

az repos show --repository contosoREPO
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoREPO",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoREPO",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikamprime/Fabrikam%20Fiber/contosoREPO",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoREPO"
}

Aktualisieren eines Repositorys

Sie können az repos update verwenden, um den Standardzweig zu aktualisieren oder ein Repository umzubenennen.

az repos show --repository
                [--default-branch]
                [--detect {false, true}]
                [--name]
                [--org]
                [--project]
                [--subscription]

Parameter

Parameter	BESCHREIBUNG
repository	Name oder ID eines Repositorys.
default-branch	Geben Sie den Standardzweig an, der für das Repository festgelegt werden soll. Beispiel: "refs/heads/live" oder "live".
detect	Die Organisation wird automatisch erkannt. Akzeptierte Werte: false, true.
name	Neuer Name für das Repository.
org, organization	Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe az devops configure -d organization=<ORG_URL>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe az devops configure -d project=<NAME_OR_ID>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.

Beispiel

Der folgende Befehl umbenannt die contosoREPO in contosoFabrikam für die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

Geben Sie für weitere Details den folgenden Befehl ein:

az repos update --repository contosoREPO --name contosoFabrikam
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoFabrikam",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/Fabrikam%20Fiber/contosoFabrikam",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam"
}

Listenrichtlinien

Verwenden Sie az repos-Richtlinienliste , um alle Richtlinien für alle Projektrepositorys und Zweigstellen auflisten. Verwenden Sie die repository-id Parameter branch , um Richtlinien für bestimmte Repositorys und Verzweigungen auflisten.

az repos policy list [--branch]
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--query-examples]
                     [--repository-id]
                     [--subscription]

Parameter

Parameter	BESCHREIBUNG
branch	Verzweigungsname, um Ergebnisse nach exakter Übereinstimmung zu filtern. Der --repository-id Parameter ist erforderlich, um den Verzweigungsfilter zu verwenden. Beispiel: --branch main.
detect	Die Organisation wird automatisch erkannt. Akzeptierte Werte: false, true.
org, organization	Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe az devops configure -d organization=<ORG_URL>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe az devops configure -d project=<NAME_OR_ID>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde.
query-examples	Empfohlene JMESPath-Zeichenfolge. Sie können eine der Abfragen kopieren und nach dem --query Parameter in doppelte Anführungszeichen einfügen, um die Ergebnisse anzuzeigen. Sie können ein oder mehrere positionale Schlüsselwörter hinzufügen, sodass Vorschläge auf diesen Schlüsselwörtern basieren.
repository-id	ID des Repositorys, um Ergebnisse nach exakter Übereinstimmung zu filtern. Beispielsweise --repository-id e556f204-53c9-4153-9cd9-ef41a11e3345.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.

Beispiel

Der folgende Befehl gibt alle Richtlinien zurück, die im Standardprojekt wirksam sind. In diesem Beispiel wird die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"verwendet.

az repos policy list --output table

ID    Name                         Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------------  -------------  ------------  ------------------------------------  ---------------------
1     Git repository settings      True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches
3     Work item linking            True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
5     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
6     Comment requirements         False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
7     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/big-branch
8     Work item linking            False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/big-branch
9     Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
10    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
11    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
12    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
13    Required reviewers           False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Richtliniendetails anzeigen

Um die Details einer Richtlinie anzuzeigen, verwenden Sie az repos policy show. Sie können die Richtlinien-ID abrufen, indem Sie ausführen az repos policy list.

az repos policy show --id
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--query-examples]
                     [--subscription]

Parameter

Parameter	BESCHREIBUNG
id, policy-id	ID der Richtlinie. Erforderlich.
detect	Die Organisation wird automatisch erkannt. Akzeptierte Werte: false, true.
org, organization	Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe az devops configure -d organization=<ORG_URL>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe az devops configure -d project=<NAME_OR_ID>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde.
query-examples	Empfohlene JMESPath-Zeichenfolge. Sie können eine der Abfragen kopieren und nach dem --query Parameter in doppelte Anführungszeichen einfügen, um die Ergebnisse anzuzeigen. Sie können ein oder mehrere positionale Schlüsselwörter hinzufügen, sodass Vorschläge auf diesen Schlüsselwörtern basieren.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.

Beispiel

Im folgenden Beispiel wird der Name und die Details für die Richtlinien-ID 1 im Standardprojekt dargestellt. In diesem Beispiel wird die Standardkonfiguration verwendet. az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy show --id 1 --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
1     Git repository settings  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Updaterichtlinien

Sie können azure CLI az repos Policy Update mit einer Richtlinienkonfigurationsdatei verwenden, um Richtlinien zu aktualisieren. Eine Richtlinienkonfigurationsdatei kann eine Richtlinie jeweils über mehrere Bereiche anwenden. Weitere Informationen finden Sie unter Konfigurieren von Git-Repositoryrichtlinien mithilfe einer Konfigurationsdatei. Beispiele für Richtlinienkonfigurationsdateien finden Sie unter "Konfigurationen – Erstellen".

az repos policy update --config
                       --id
                       [--detect {false, true}]
                       [--org]
                       [--project]
                       [--subscription]

Parameter

Parameter	BESCHREIBUNG
--config, --policy-configuration	Lokaler Dateipfad für die Richtlinienkonfigurationsdatei. Verwenden Sie backslash \ beim Eingeben des Verzeichnispfads. Erforderlich.
id, policy-id	ID der Richtlinie, die aktualisiert werden soll. Erforderlich.
detect	Die Organisation wird automatisch erkannt. Akzeptierte Werte: false, true.
org, organization	Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe az devops configure -d organization=<ORG_URL>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe az devops configure -d project=<NAME_OR_ID>von . Erforderlich , wenn nicht als Standard konfiguriert oder über git config aufgenommen wurde.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.

Beispiel

Die folgende Policy.json-Datei legt die Mindestüberprüfungsrichtlinie fest, um drei Genehmigungen in allen Zweigen in allen main Repositorys im Standardprojekt erforderlich zu machen.

{
  "isEnabled": true,
  "isBlocking": false,
  "type": {
    "id": "fa4e907d-c16b-4a4c-9dfa-4906e5d171dd"
  },
  "settings": {
    "minimumApproverCount": 3,
    "creatorVoteCounts": false,
    "scope": [
      {
        "repositoryId": null,
        "refName": "refs/heads/main",
        "matchKind": "exact"
      }
    ]
  }
}

Die az repos policy update Befehlszeile aktualisiert die Mindestüberprüfungsrichtlinie pro datei "policy.json ". Sie können die Richtlinien-ID mithilfe der Az-Repos-Richtlinienliste finden. Im Beispiel wird die Standardkonfiguration verwendet. az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy update --config C:\policies\policy.json --id 7 --output table

ID    Name                         Is Blocking    Is Enabled    Branch
----  ---------------------------  -------------  ------------  -----------------
7     Minimum number of reviewers  False          True          refs/heads/main

Azure DevOps CLI-Befehle werden für Azure DevOps Server lokal nicht unterstützt.

Standardzweigname

Sie können einen Standard-Repository-Verzweigungsnamen auf Organisations- oder Projektebene festlegen. Die Einstellung auf Organisationsebene wirkt sich für alle neuen Repositorys in allen Projekten in der Organisation aus. Die Einstellung auf Projektebene wirkt sich auf alle neuen Repositorys in einem Projekt aus, und übergibt jeden Namen auf Organisationsebene.

Ihre Möglichkeiten:

• Wählen Sie einen beliebigen Rechtszweignamen aus, der verwendet werden soll, wenn ein Repository initialisiert wird.
• Ändern Sie den Standardnamen jederzeit, um alle zukünftigen Repositorys zu beeinflussen.
• Ändern Sie den Standardzweignamen für jedes bestimmte Repository jederzeit.

Wenn Sie das Standardzweignamenfeature nicht aktivieren, initialisieren Repositorys mit dem Azure Repos Standardzweignamenmain.

So legen Sie einen Standardzweignamen auf Organisationsebene fest:

1. Wählen Sie auf Der Seite "Azure DevOps-Organisation" die Einstellungen "Organisation" unten links aus, und wählen Sie dann "Repositorys " in der linken Navigation aus.
2. Legen Sie auf der Seite "Alle Repositorys " den Standardzweignamen für neue Repositorys auf "On" fest, und geben Sie dann einen Standardzweignamen ein.

So legen Sie einen Standardzweignamen auf Projektebene fest:

1. Wählen Sie auf Der Seite "Azure DevOps"-Projekt die Projekteinstellungen unten links aus, und wählen Sie dann "Repositorys " in der linken Navigation aus.
2. Legen Sie auf der Registerkarte "Einstellungen " auf der Seite "Alle Repositorys " den Standardzweignamen für neue Repositorys auf "Ein" fest, und geben Sie dann einen Standardzweignamen ein.

Hinweis

Der Standardzweigname für neue Repositorys erfordert Azure DevOps Server 2020.1 oder höher.

Branch-Berechtigungsverwaltung

Sie können steuern, wer Berechtigungen für Repository-Verzweigungen verwalten kann, indem Sie eine Berechtigungsverwaltungseinstellung für alle Git-Repositorys oder für einzelne Repositorys festlegen. Wenn Sie benutzern das Verwalten von Berechtigungen für ihre erstellten Verzweigungen auf der Ebene "Alle Repositorys " ermöglichen, werden alle neuen Projektrepositorys konfiguriert, um Benutzern die Verwaltung von Berechtigungen für ihre erstellten Zweige zu ermöglichen.

So verwalten Sie diese Einstellung:

1. Wählen Sie auf Der Seite "Azure DevOps"-Projekt die Projekteinstellungen unten links aus, und wählen Sie dann "Repositorys " in der linken Navigation aus.
2. Legen Sie auf der Registerkarte "Einstellungen " auf der Seite "Alle Repositorys " fest, dass Benutzer Berechtigungen für ihre erstellten Verzweigungen auf"Ein " oder "Aus" verwalten können.

So aktivieren oder deaktivieren Sie diese Einstellung für einzelne Repositorys:

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie dann ein Repository aus.
2. Legen Sie auf der Registerkarte "Einstellungen " der <Seite "Repositoryname> " die Berechtigungsverwaltung auf "Ein " oder "Aus" fest.

Gravatarbilder

Diese Einstellung aktiviert oder deaktiviert die Verwendung von Gravatar-Bildern für Benutzer außerhalb Ihres Unternehmens.

Gravatar-Bilder sind eine Einstellung auf Organisationsebene.

1. Wählen Sie auf Der Seite "Azure DevOps-Organisation" die Einstellungen "Organisation" unten links aus, und wählen Sie dann "Repositorys " in der linken Navigation aus.
2. Legen Sie auf der Seite "Alle Repositorys " Gravatar-Bilder auf "Ein " oder "Aus" fest.

Gravatar-Bilder sind eine Projektebeneneinstellung für alle Repositorys.

1. Wählen Sie auf Der Seite "Azure DevOps"-Projekt die Projekteinstellungen unten links aus, und wählen Sie dann "Repositorys " in der linken Navigation aus.
2. Legen Sie auf der Registerkarte "Einstellungen " auf der Seite "Alle Repositorys " Gravatarbilder auf "Ein " oder "Aus" fest.

Gravatar-Bilder sind eine Projektebeneneinstellung für alle Repositorys.

1. Wählen Sie auf Der Seite "Azure DevOps"-Projekt die Projekteinstellungen unten links aus, und wählen Sie dann "Repositorys " in der linken Navigation aus.
2. Legen Sie auf der Registerkarte "Einstellungen " auf der Seite "Alle Repositorys " Gravatarbilder auf "Ein " oder "Aus" fest.

Gravatar-Bilder sind eine einzelne Repositoryeinstellung.

Aktivieren von Forks

Diese Repositoryeinstellung steuert, ob Benutzer neue serverseitige Forks erstellen können. Das Deaktivieren dieser Einstellung entfernt keine vorhandenen Forks.

1. Wählen Sie in der linken Navigation imProjekteinstellungen Repositorys aus.
2. Wählen Sie auf der Registerkarte "Repositorys " auf der Seite "Alle Repositorys " ein Repository aus.
3. Legen Sie auf der Registerkarte "Einstellungen " der <Seite "Repositoryname> " Forks auf "Ein " oder "Aus" fest.

Verknüpfungseinstellungen für Arbeitselemente

Diese Repositoryeinstellungen verwalten die Verknüpfung von Arbeitselementen.

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie dann ein Repository aus.
2. Aktivieren oderdeaktivieren Sie auf der Registerkarte "Einstellungen" auf der <Seite "Repositoryname>" die Einstellungen.

Commit-Erwähnungsverknüpfung

Wenn aktiviert, binden Sie Nachrichten, die gefolgt von einer gültigen Arbeitselement-ID enthalten # , den Commit automatisch mit diesem Arbeitselement verknüpft. Deaktivieren Sie diese Einstellung, wenn das Repository zuvor ein anderes Konto oder einen anderen Dienst verwendet hat. Diese Repositorys verfügen möglicherweise über Commitnachrichten mit # Erwähnungen, die nicht mit den Arbeitselement-IDs im aktuellen Konto übereinstimmen.

Commit-Erwähnung der Arbeitselementauflösung

Aktivieren Sie diese Einstellung, um Arbeitselemente automatisch abzuschließen, wenn verknüpfte Pullanforderungen abgeschlossen sind. Diese Einstellung ermöglicht es auch, andere Übergangszustände für Arbeitselemente in Pull-Anforderungs-Commitnachrichten anzugeben. Weitere Informationen finden Sie unter "Automatisches Abschließen von Arbeitselementen mit Pullanforderungen".

Commit-Erwähnung der Arbeitselementauflösung

Aktivieren Sie diese Einstellung, um diese Arbeitselemente automatisch abzuschließen, wenn Sie die PR erfolgreich abschließen. Weitere Informationen finden Sie unter "Automatisches Abschließen von Arbeitselementen mit Pullanforderungen".

Einstellungen für den Übergang von Arbeitselementen

Standardmäßig erinnert sich die Option zum Abschließen verknüpfter Arbeitselemente während des Pullanforderungsabschlusses an die letzte Wahl jedes Benutzers. Teams, die Benutzer davon abhindern möchten, Arbeitselemente mit ihren Pullanforderungen abzuschließen, können diese Einstellung deaktivieren. Benutzer müssen sich dann bei jedem Abschluss einer Pull-Anforderung anmelden, um Arbeitselemente abzuschließen.

Einstellung "Strikter Abstimmungsmodus"

In bestimmten Situationen können Benutzer, die keine Mitwirkenden an ein Repository sind, eine Pullanforderung übermitteln und dazu führen, dass sie je nach Richtlinien zusammengeführt werden. Um diese Möglichkeit zu verhindern, aktivieren Sie den strikten Abstimmungsmodus , um die erforderliche Berechtigung für die Abstimmung auf Repository-Pullanforderungen für Mitwirken zu ändern. Das Aktivieren dieser Einstellung wird empfohlen, wenn Sie sich auf Benutzer-Forks in Azure Repos verlassen.

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie dann ein Repository aus.
2. Legen Sie auf der Registerkarte "Einstellungen " der <Seite "Repositoryname> " den "Strikten Abstimmungsmodus " auf "Ein " oder "Aus" fest.

Repositoryeinstellung deaktivieren

Durch Aktivieren dieser Einstellung wird der Zugriff auf das Repository deaktiviert, einschließlich Builds und Pullanforderungen, aber das Repository wird mit einer Warnung ermittelt.

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie dann ein Repository aus.
2. Legen Sie auf der Registerkarte "Einstellungen " der <Seite "Repositoryname> " unter "Repository deaktivieren" das Repository auf "Ein " oder "Deaktivieren" fest.

Einstellung für durchsuchbare Verzweigungen

Standardmäßig gilt die Codesuche in Dateien nur für den Standardzweig. Sie können bis zu fünf weitere Verzweigungen hinzufügen, um zu suchen.

Wichtig

Um Code in Repositorys zu durchsuchen, müssen Sie die Marketplace-Codesuche-Erweiterung installieren. Wenn suchbare Zweige auf der Registerkarte " Repositoryeinstellungen " nicht angezeigt werden, stellen Sie sicher, dass die Erweiterung installiert ist.

So fügen Sie Zweige für die Codesuche hinzu:

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie dann ein Repository aus.
2. Wählen Sie auf der Registerkarte "Einstellungen " der <Seite "Repositoryname> " die + Option in "Durchsuchbare Verzweigungen" aus.
3. Wählen Sie eine Verzweigung aus, die in die Suche aufgenommen werden soll, und wählen Sie dann "Verzweigung hinzufügen" aus.

Domänenübergreifende Verzweigungsrichtlinien

Sie können Richtlinien für einen bestimmten Verzweigungsnamen oder für die Standardverzweigung für alle Repositorys in einem Projekt festlegen. Sie können beispielsweise zwei Mindestprüfer für alle Pullanforderungen in jeder main Verzweigung für alle Projektrepositorys benötigen.

So legen Sie Richtlinien zum Schutz bestimmter oder Standardverzweigungsnamen in einem Projekt fest:

1. Wählen Sie in den ProjekteinstellungenRepositorys in der linken Navigation aus.

2. Wählen Sie auf der Seite "Alle Repositorys " die Registerkarte "Richtlinien " aus.

3. Wählen Sie unten auf der Seite die Pluszeichen-Anmelderichtlinien+ aus.

4. Wählen Sie auf dem Bildschirm " Verzweigungsschutz hinzufügen " die Standardverzweigung jedes Repositorys aus, oder schützen Sie aktuelle und zukünftige Verzweigungen, die einem angegebenen Muster entsprechen.

   Wenn Sie die zweite Option auswählen, geben Sie den Verzweigungsnamen ein, um den Schutz zu schützen. Eine Informationsnachricht informiert Sie darüber, wie viele aktuelle Verzweigungen betroffen sind. Die Verzweigung muss noch nicht vorhanden sein, um den Verzweigungsnamen zu schützen.

5. Klicken Sie auf Erstellen.

   

6. Legen Sie auf der Seite "Domänenübergreifende Richtlinien für <Verzweigungsnamen> " die gewünschten Richtlinien für die geschützten Verzweigungen fest. Weitere Informationen zu Verzweigungsrichtlinien finden Sie unter Branch-Richtlinien.

   

E-Mail-Überprüfungsrichtlinie zum Commit des Autors

Diese Richtlinie blockiert commits für ein Repository durch Commitautoren, deren E-Mail-Adressen keinem Muster entsprechen.

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.

2. Legen Sie auf der Registerkarte "Richtlinien " der Seite "Alle Repositorys " oder <"Repositorynamen> " unter " Repositoryrichtlinien" die E-Mail-Überprüfung für den Commit auf"Ein " oder "Aus" fest.

3. Wenn Sie die Richtlinie aktivieren, geben Sie die E-Mail-Adresse oder Die Adressen an, die übereinstimmen sollen.

   Sie können genaue E-Mail-Adressen angeben oder Wildcards verwenden. Verwenden Sie ; als Trennzeichen für mehrere E-Mail-Muster. Email Muster, die ! präfixiert sind, werden ausgeschlossen. Die Bestellung ist wichtig.

Dateipfadüberprüfungsrichtlinie

Sie können eine Richtlinie festlegen, die verhindert, dass ein Commit für ein Repository von Dateipfaden ausgeführt wird, die einem Muster entsprechen.

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.

2. Legen Sie auf der Registerkarte "Richtlinien " der Seite "Alle Repositorys " oder <"Repositorynamen> " unter " Repositoryrichtlinien" die Überprüfung des Dateipfads auf "Ein " oder "Aus" fest.

3. Wenn Sie die Richtlinie aktivieren, geben Sie den zu blockierenden Pfad oder Pfad an.

   Sie können genaue Pfade und Wildcards angeben. Genaue Pfade beginnen mit /. Sie können auch mehrere Pfade angeben, indem Sie es als Trennzeichen verwenden ; . Pfade, die präfixiert sind ! , werden ausgeschlossen. Die Bestellung ist wichtig.

Fallerzwingungsrichtlinie

Git ist groß- und kleinschreibungsempfindlich, d. h. eine Datei namens Foo.txt unterscheidet sich von einer Datei namens foo.txt. Windows und macOS sind jedoch standardmäßig bei Dateisystemen mit Groß-/Kleinschreibung identisch, was bedeutet, dass Foo.txt und foo.txt denselben Namen haben. Diese Diskrepanz kann Zu Problemen führen, wenn jemand in einem System mit Groß-/Kleinschreibung Dateien, Ordner, Verzweigungen oder Tags verschiebt, die sich nur nach Groß-/Kleinschreibung unterscheiden. Weitere Informationen finden Sie unter Git Cross-Platform Compatibility.

Wenn sich die meisten Ihrer Mitwirkenden auf Windows oder macOS befinden, empfiehlt es sich, die Fallerzwingungsrichtlinie zu aktivieren. Bei der Groß-/Kleinschreibung wird der Server vom Standardmodus für Groß-/Kleinschreibung wechselt, wobei File.txt und file.txt unterscheiden, zu einem Windows- und macOS-freundlichen Modus, in dem File.txt und file.txt als dieselbe Datei betrachtet werden. Diese Einstellung gilt für Dateien, Ordner, Branches und Tags.

Diese Einstellung verhindert, dass Mitwirkende Nur-Fall-Unterschiede einführen. Die Einstellung verhindert Groß-/Kleinschreibungskonflikte, indem Pushs blockiert werden, die das Formatieren von Namen in Dateien, Ordnern, Verzweigungen und Tags ändern. Der Benutzer muss seinen ungesubbten Verlauf neu schreiben, um das Problem zu beheben, und versuchen Sie es dann erneut.

Diese Einstellung korrigiert kein Repository, das bereits Objekte enthält, die sich nur nach Groß-/Kleinschreibung unterscheiden. Es ist am besten, solche Probleme zu beheben, bevor Sie die Richtlinie aktivieren. Benennen Sie Dateien und Ordner um, oder erstellen Sie Verzweigungen und Tags erneut, um nicht in Konflikt stehende Namen zu verwenden.

Browser

So legen Sie die Richtlinie für die Groß-/Kleinschreibungserzwingung fest:

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
2. Legen Sie auf der Registerkarte "Richtlinien " der Seite "Alle Repositorys " oder <"Repositorynamen> " unter " Repositoryrichtlinien" die Groß-/Kleinschreibung auf "Ein " oder "Aus" fest.

Hinweis

Die Fallerzwingungsrichtlinie erfordert TFS 2018.2 oder höher.

Erste Schritte mit der Azure DevOps-CLI

Sie können azure CLI az repos policy case-enforcement create and az repos policy case-enforcement update to configure or update case enforcement policy.

Erstellen einer Fallerzwingungsrichtlinie

Verwenden Sie az repos case-enforcement create to create a case enforcement policy.

az repos policy case-enforcement create --blocking {false, true}
                                        --enabled {false, true}
                                        --repository-id
                                        [--detect {false, true}]
                                        [--org]
                                        [--project]

Parameter

Parameter	BESCHREIBUNG
blocking	Blockieren, wenn die Richtlinie nicht erfüllt ist. Akzeptierte Werte: false, true. Erforderlich.
enabled	Aktivieren Sie die Richtlinie. Akzeptierte Werte: false, true. Erforderlich.
repository-id	ID des Repositorys, auf das die Richtlinie angewendet werden soll. Erforderlich.
detect	Organisation automatisch erkennen. Akzeptierte Werte: false, true.
org	Url der Azure DevOps-Organisation. Sie können die Standardorganisation mithilfe von az devops configure -d organization=<ORG_URL>. Erforderlich , wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe von az devops configure -d project=<NAME_OR_ID>. Erforderlich , wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde.

Beispiel

Im folgenden Beispiel wird eine erforderliche Fallerzwingungsrichtlinie im Fabrikam Repository implementiert. Sie können die Repository-ID mithilfe der Az-Repos-Liste abrufen. In diesem Beispiel wird die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"verwendet.

az repos policy case-enforcement create --blocking true --enabled true --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
40    Git repository settings  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Update case enforcement policy

Verwenden Sie az repos policy case-enforcement update to manage Case enforcement policy policy.

az repos policy case-enforcement update --id
                                        [--blocking {false, true}]
                                        [--detect {false, true}]
                                        [--enabled {false, true}]
                                        [--org]
                                        [--project]
                                        [--repository-id]

Parameter

Parameter	BESCHREIBUNG
id, policy-id	ID der zu aktualisierenden Richtlinie. Erforderlich.
blocking	Blockieren, wenn die Richtlinie nicht erfüllt ist. Akzeptierte Werte: false, true.
detect	Organisation automatisch erkennen. Akzeptierte Werte: false, true.
enabled	Aktivieren Sie die Richtlinie. Akzeptierte Werte: false, true.
org	Url der Azure DevOps-Organisation. Sie können die Standardorganisation mithilfe von az devops configure -d organization=<ORG_URL>. Erforderlich , wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe von az devops configure -d project=<NAME_OR_ID>. Erforderlich , wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde.
repository-id	ID des Repositorys, auf das die Richtlinie angewendet werden soll.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.

Beispiel

Im folgenden Beispiel wird die Fallerzwingungsrichtlinie im Fabrikam Repository aktualisiert, damit sie nicht mehr aktiviert oder blockiert werden kann. In diesem Beispiel wird die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"verwendet.

az repos policy case-enforcement update --blocking false --enabled false --policy-id 40 --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
40    Git repository settings  False          False         d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Azure DevOps CLI-Befehle werden für Azure DevOps Server lokalen Azure DevOps Server nicht unterstützt.

Richtlinie für reservierte Namen

Nicht alle Dateinamen sind für die drei wichtigsten Betriebssystemdateisysteme zulässig: Windows, macOS und Linux. Commits zu einem freigegebenen Repository enthalten möglicherweise Datei- oder Ordnernamen, die auf einer oder mehreren Plattformen ungültig sind. Wenn ungültige Dateien oder Ordner abgerufen und auf diesen Plattformen ausgecheckt werden, können Arbeitsverzeichnisse beschädigt werden. Weitere Informationen finden Sie unter Git Cross-Platform Compatibility.

Sie können Richtlinien aktivieren oder deaktivieren, um Einschränkungen für Datei- und Ordnernamen zu platzieren. Die Einstellung "Reservierte Namen " blockiert Pushes an ein Repository, das Datei- oder Ordnernamen enthält, die auf allen Plattformen ungültig sind. Informationen dazu, welche Namen ungültig sind, finden Sie unter Git Cross-Platform Compatibility.

So legen Sie die Richtlinie für reservierte Namen fest:

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
2. Legen Sie auf der Registerkarte "Richtlinien " der Seite "Alle Repositorys " oder <"Repositoryname> " unter " Repositoryrichtlinien" "Reservierte Namen " auf "Ein " oder "Aus" fest.

Maximale Pfadlängenrichtlinie

Nicht alle Pfadlängen sind für die drei wichtigsten Betriebssystemdateisysteme zulässig: Windows, macOS und Linux. Commits zu einem freigegebenen Repository enthalten möglicherweise Dateien oder Verzeichnisse mit Pfadlängen, die auf einer oder mehreren Plattformen ungültig sind. Wenn diese Dateien oder Verzeichnisse abgerufen und auf einer Plattform ausgecheckt werden, auf der sie ungültig sind, können Arbeitsverzeichnisse beschädigt werden. Weitere Informationen finden Sie unter Git Cross-Platform Compatibility.

Die Einstellung "Maximale Pfadlänge " blockiert Pushes, die Dateien oder Verzeichnisse mit Pfadlängen enthalten, die auf jeder Plattform ungültig sind. Informationen dazu, welche Pfadlängen ungültig sind, finden Sie unter Git Cross-Platform Compatibility. Wenn Sie diese Einstellung aktivieren, lautet 248der Standardwert , da diese maximale Länge 100 % auf allen drei hauptplattformen unterstützt wird.

Sie können den maximalen Pfadwert ändern. Wenn Sie beispielsweise nur über macOS- oder Linux-Entwickler in Ihrer Organisation verfügen, können Sie die maximale Länge auf den Wert festlegen, der auf beiden Plattformen unterstützt wird. 1016 Sie können auch einen niedrigeren maximalen Pfadwert festlegen, um die Verzeichnisbenennungskonventionen Ihrer Organisation zu erzwingen.

So legen Sie die maximale Pfadlängenrichtlinie fest:

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
2. Legen Sie auf der Registerkarte "Richtlinien " der Seite "Alle Repositorys " oder <"Repositoryname> " unter " Repositoryrichtlinien" die maximale Pfadlänge auf "Ein " oder "Aus" fest.
3. Wenn Sie die Einstellung aktiviert haben, geben Sie eine maximale Pfadlänge ein.

Maximale Dateigrößenrichtlinie

Große Dateien, die in Git eingecheckt sind, verbleiben unbegrenzt im Repository, wodurch die Klonzeiten und die Datenträgernutzung erhöht werden. Anleitungen zum Verwalten großer Dateien finden Sie unter Verwalten und Speichern großer Dateien in Git.

Die Richtlinieneinstellung "Maximale Dateigröße " blockiert Dateien über eine bestimmte Größe beim Eingeben des Repositorys. Wenn ein Push eine neue oder aktualisierte Datei enthält, die größer als der in dieser Einstellung konfigurierte Grenzwert ist, wird der Push blockiert. Der Benutzer muss seinen ungesubbten Verlauf neu schreiben, um die große Datei zu entfernen, und versuchen Sie es erneut.

Browser

So konfigurieren Sie die Richtlinie für maximale Dateigröße :

1. Wählen SieProjekteinstellungen-Repositorys> aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
2. Legen Sie auf der Registerkarte "Richtlinien " der Seite "Alle Repositorys " oder <"Repositoryname> " unter " Repositoryrichtlinien" die Maximale Dateigröße auf "Ein " oder "Aus" fest.
3. Wenn Sie die Einstellung aktiviert haben, wählen Sie eine maximale Dateigröße aus.

Hinweis

Die Richtlinie für die maximale Dateigröße erfordert TFS 2018.2 oder höher.

Erste Schritte mit der Azure DevOps-CLI

Verwenden Sie az repos policy file-size create and az repos policy file-size update to manage maximum file size policy.

Erstellen einer Dateigrößesrichtlinie

az repos policy file-size create --blocking {false, true}
                                 --enabled {false, true}
                                 --maximum-git-blob-size
                                 --repository-id
                                 --use-uncompressed-size {false, true}
                                 [--detect {false, true}]
                                 [--org]
                                 [--project]
                                 [--subscription]

Parameter

Parameter	BESCHREIBUNG
blocking	Blockieren, wenn die Richtlinie nicht erfüllt ist. Akzeptierte Werte: false, true. Erforderlich.
enabled	Aktivieren Sie die Richtlinie. Akzeptierte Werte: false, true. Erforderlich.
maximum-git-blob-size	Maximale Git-Blobgröße in Bytes. Wenn Sie z. B. ein Limit von 10 Byte angeben möchten, --maximum-git-blob-size 10.ist erforderlich.
repository-id	ID des Repositorys, auf das die Richtlinie angewendet werden soll. Erforderlich.
use-uncompressed-size	Gibt an, ob die nicht komprimierte Größe verwendet werden soll. Akzeptierte Werte: false, true. Erforderlich.
detect	Organisation automatisch erkennen. Akzeptierte Werte: false, true.
org	Url der Azure DevOps-Organisation. Sie können die Standardorganisation mithilfe von az devops configure -d organization=<ORG_URL>. Erforderlich , wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe von az devops configure -d project=<NAME_OR_ID>. Erforderlich , wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.

Beispiel

Im folgenden Beispiel wird eine 1 GB blockierte maximale Dateigrößenrichtlinie im Fabrikam Repository erstellt. Sie können die Repository-ID mithilfe der Az-Repos-Liste abrufen. In diesem Beispiel wird die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"verwendet.

az repos policy file-size create --blocking true --enabled true --maximum-git-blob-size 10485760 --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --use-uncompressed-size true --output table

ID    Name                   Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------  -------------  ------------  ------------------------------------  ------------
45    File size restriction  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Aktualisieren der Dateigrößesrichtlinie

Verwenden Sie az repos policy file-size update , um die maximale Dateigrößenrichtlinie zu verwalten.

az repos policy file-size update --id
                                 [--blocking {false, true}]
                                 [--detect {false, true}]
                                 [--enabled {false, true}]
                                 [--maximum-git-blob-size]
                                 [--org]
                                 [--project]
                                 [--repository-id]
                                 [--subscription]
                                 [--use-uncompressed-size {false, true}]

Parameter

Parameter	BESCHREIBUNG
id, policy-id	ID der zu aktualisierenden Richtlinie. Erforderlich.
blocking	Blockieren, wenn die Richtlinie nicht erfüllt ist. Akzeptierte Werte: false, true.
detect	Organisation automatisch erkennen. Akzeptierte Werte: false, true.
enabled	Aktivieren Sie die Richtlinie. Akzeptierte Werte: false, true.
maximum-git-blob-size	Maximale Git-Blobgröße in Bytes.
org	Url der Azure DevOps-Organisation. Sie können die Standardorganisation mithilfe von az devops configure -d organization=<ORG_URL>. Erforderlich , wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.
project, p	Name oder ID des Projekts. Sie können das Standardprojekt mithilfe von az devops configure -d project=<NAME_OR_ID>. Erforderlich , wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde.
repository-id	ID des Repositorys, auf das die Richtlinie angewendet werden soll.
subscription	Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s <NAME_OR_ID> konfigurieren.
use-uncompressed-size	Gibt an, ob die nicht komprimierte Größe verwendet werden soll. Akzeptierte Werte: false, true.

Beispiel

Im folgenden Beispiel wird die maximale Dateigröße im Fabrikam Repository aktualisiert. Im Beispiel wird die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"verwendet.

az repos policy file-size update --id 45 --maximum-git-blob-size 20971520 --output table

ID    Name                   Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------  -------------  ------------  ------------------------------------  ------------
45    File size restriction  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Azure DevOps CLI-Befehle werden für Azure DevOps Server lokalen Azure DevOps Server nicht unterstützt.

Nächste Schritte

Verbessern der Codequalität durch Branchrichtlinien

Verwandte Artikel

• Konfigurieren von Git-Repositoryrichtlinien mithilfe einer Konfigurationsdatei
• Git-Standardberechtigungen (Sicherheit)
• Festlegen von Berechtigungen (Sicherheit)
• Dienstübergreifende Integration – Übersicht