Freigeben über

Benennungseinschränkungen und -konventionen

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

In diesem Artikel werden die Benennungsregeln, Konventionen und Einschränkungen für Azure DevOps-Komponenten beschrieben. Benennungsregeln, Einschränkungen und Konventionen tragen dazu bei, eine konsistente Benutzererfahrung zu gewährleisten und Kompatibilität mit anderen Anwendungen zu gewährleisten.

Allgemeine Hinweise

Zu den üblichen Einschränkungen gehören die Begrenzung der Zeichenlänge für Namen, das Verbot von Sonderzeichen und die Einhaltung der Eindeutigkeit von Namen innerhalb einer Objektgruppe.

Wichtig

Wenn Sie die Azure DevOps-APIs anstelle der Benutzeroberfläche verwenden, können Sie direkt einen Namen angeben, der in der Benutzeroberfläche eingeschränkte Zeichen enthalten kann. Um Konsistenz zu gewährleisten und unbeabsichtigte Probleme zu verhindern, befolgen Sie die Ui-Einschränkungen. Überprüfen Sie Namen programmgesteuert, und behandeln Sie Sonderzeichen entsprechend.

Vom System reservierte Namen

Vermeiden Sie die Verwendung reservierter Systemnamen wie die folgenden Beispiele:

  • AUX
  • COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
  • CON
  • DefaultCollection
  • LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
  • NUL
  • PRN
  • Server, SignalR
  • Web oder WEB

Weitere Informationen zu reservierten Namen finden Sie unter Dateinamen, Pfade und Namespaces.

Azure Artifacts

Universelle Azure Artifacts-Pakete und Feeds müssen den folgenden Einschränkungen entsprechen:

Einschränkungstyp Einschränkung
Paketname - Muss aus Kleinbuchstaben bestehen.
- Muss mit alphanumerischen Zeichen beginnen und enden.
- Kann nur alphanumerische Zeichen und nicht zusammenhängende Bindestriche -, Unterstriche _oder Punkte .enthalten.
Paketversion - Muss ohne Buildmetadaten klein geschrieben sein.
Name des Feeds - Muss mit alphanumerischen Zeichen beginnen und enden.
- Unempfindlich gegenüber Groß-/Kleinschreibung, darf sich jedoch nicht nur durch Groß- und Kleinschreibung von einem anderen Feednamen unterscheiden.
- Darf nicht mit Punkt . oder Unterstrich _ beginnen oder mit Punkt . enden.
- Darf keines der folgenden Zeichen enthalten: @~;{}'+=,<>|/\?:&$*"#[]%.

Azure Boards

Azure Boards verwendet Arbeitsaufgaben zum Planen und Nachverfolgen von Softwareentwicklungsprojekten. Arbeitselemente beschreiben die zu erledigende Arbeit, weisen Arbeiten zu, verfolgen den Status und koordinieren die Anstrengungen innerhalb eines Teams. Verschiedene Arten von Arbeitsaufgaben, z. B. Benutzergeschichten, Aufgaben, Fehler und Probleme, verfolgen verschiedene Arten von Informationen. Weitere Informationen finden Sie in der Dokumentation zu Azure Boards.

Aufgabenverfolgungsobjekte sind einem oder mehreren Namen zugeordnet. Alle Objekte mit Ausnahme von Arbeitsaufgabentypen und globalen Listen weisen anzeigefreundliche Anzeigenamen auf, bei denen es sich um eindeutige, benutzerdefinierte Bezeichner für Felder handelt. Die Verwendung benutzerfreundlicher Namen gewährleistet Konsistenz zwischen Projekten und Elementtypen in einer Projektsammlung.

Arbeitsaufgabentypen und globale Listen sind Referenznamen zugeordnet. Das System verwendet die Referenznamen intern, und Sie können sie nicht mehr ändern, nachdem sie definiert wurden.

Mehrere Elemente, die mit Arbeitsaufgaben verbunden sind, unterliegen Einschränkungen, einschließlich Verweisnamen, Anzeigenamen, Feldnamen und Anhangsgröße.

Bereichs- und Iterationspfade

Die Felder "Bereichspfad" und Iterationspfad stellen eine Baumstrukturhierarchie für die Gruppierung von Arbeit bereit. Bereichspfade gruppieren Arbeitsaufgaben nach Produkt, Funktion oder Featurebereich. Iterationspfade gruppieren Arbeitsaufgaben in Sprints, Meilensteine oder Zeiträume für die Adressierung der Arbeit.

Diese Felder mit mehreren Knoten verwenden das Backslash-Zeichen \, um die Hierarchie von Knoten innerhalb der Baumstruktur zu kennzeichnen. Die Namen, die Sie Kindknoten zuweisen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Knotenlänge Darf nicht mehr als 255 Zeichen enthalten.
Reservierte Namen - Darf nicht nur aus einem Punkt . oder zwei Perioden .. bestehen.
- Darf kein vom System reservierter Name sein, z. B. PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON oder AUX. Weitere Informationen zu reservierten Namen finden Sie unter Dateinamen, Pfade und Namespaces.
Sonderzeichen für Knoten – Darf keine Unicode-Steuerzeichen enthalten.
– Darf keins der folgenden Zeichen enthalten: \ / : * ? " < > | # $ & * +.
- Darf keine Zeichen enthalten, die vom lokalen Dateisystem verboten sind. Weitere Informationen zu Windows-Zeicheneinschränkungen finden Sie unter Benennen von Dateien, Pfaden und Namespaces.
Pfadlänge Darf nicht mehr als 4.000 Unicode-Zeichen enthalten.
Pfadhierarchietiefe Muss weniger als 14 Ebenen tief sein.

Anlagen

An Arbeitselemente angefügte Dateien müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Dateigröße Darf die maximale Größe nicht überschreiten:
- Standardmäßige maximale Größe: 4.096 Kilobyte.
- Absolute maximale Größe: 2 Gigabyte.

Mehr Informationen finden Sie unter Maximale Größe von Anhängen für Arbeitselemente ändern.

Board-Spalte und Swimlane-Namen

Ein Board bietet einen visuellen Ablauf der Backlog-Arbeit. Wenn die Arbeit von der Planung bis zum Abschluss fortschreitet, aktualisieren Sie die Elemente auf der Tafel. Jede Spalte stellt eine Arbeitsstufe dar, und jede Karte stellt eine Arbeitsaufgabe in dieser Phase der Arbeit dar.

Sie können eine Tafel anpassen, indem Sie Spalten und Swimlanes hinzufügen, entfernen oder umbenennen. Spalten unterstützen den Arbeitsfluss über das Board hinweg, und Swimlanes ermöglichen es Ihnen, verschiedene Aufgaben als horizontale Bahnen auf dem Board zu verwalten.

Spalten- und Swimlane-Namen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 256 Unicode-Zeichen enthalten.
Eindeutigkeit - Spaltennamen dürfen nicht mit anderen Spaltennamen auf dem Board identisch sein.
– Swimlane-Namen dürfen nicht mit anderen Swimlane-Namen auf dem Board identisch sein.
Sonderzeichen Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.

Feldnamen

Jeder Arbeitsaufgabentyp enthält ein oder mehrere Felder, die die für diesen Arbeitsaufgabentyp gespeicherten Informationen definieren. Jedes Arbeitselementfeld weist einen zugeordneten Feldverweisnamen auf, der das Feld eindeutig identifiziert und nach der Zuordnung nicht mehr geändert werden kann. Weitere Informationen zu integrierten Arbeitselementfeldern finden Sie im Arbeitselementfeldindex.

Die Feldnamen der Arbeitselemente sind auf die Projektsammlung beschränkt. Wenn Sie einen Feldnamen umbenennen, ändern Sie ihn für alle Arbeitsaufgaben- und Arbeitsaufgabentypen, die in allen Projekten in der Auflistung definiert sind.

Die Feldnamen von Arbeitselementen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 128 Unicode-Zeichen enthalten.
Eindeutigkeit Muss innerhalb der Organisation oder der Auflistung des Projekts eindeutig sein.
Sonderzeichen - Muss mindestens ein alphabetisches Zeichen enthalten.
- Darf keines der folgenden Zeichen enthalten: .,;':~\/*?"&%$!+=()[]{}<>-|.
– Darf keine führenden oder abschließenden Leerzeichen enthalten.
- Darf nicht zwei oder mehr aufeinanderfolgende Leerzeichen enthalten.

Feldverweisnamen

Die Sprache zur Definition von Arbeitselementtypen umfasst das Konzept eines Feldreferenznamens. Feldverweisnamen können Ihnen helfen, Definitionen zwischen Team Foundation-Projektsammlungen zu portieren und Nicht-Microsoft-Integrationen zu ermöglichen, bestimmte Felder zu suchen und auf sie zu verweisen. Diese Namen, wie Namespaces in .NET Framework-Anwendungen, sind global eindeutig.

Die folgenden Felder werden in einer Arbeitsaufgabentypdefinition der Prozessvorlagen definiert:

  • Der Namespace System wird nur zur Definition aller Core-Systemfelder verwendet, die für Team Foundation-Systemfunktionen obligatorisch sind. Sie können kein eigenes System.X Feld erstellen, da sie die Funktionalität beeinträchtigen kann.

  • Der Microsoft-Namespace wird verwendet, um Felder für die Arbeitselementnachverfolgung zu definieren. Obwohl Sie ein eigenes Microsoft.X Feld erstellen können, wird dies nicht empfohlen, da es möglicherweise die Funktionalität behindert oder die Fähigkeit beeinträchtigt, ein Projekt nach einem Upgrade erfolgreich zu aktualisieren.

Kunden und Partner können eigene Feld-Namespaces für benutzerdefinierte Arbeitselementtypen erstellen. Beschreibungen von Systemfeldern und Feldern, die in den Standardprozessvorlagen definiert sind, finden Sie im Index der Arbeitsaufgabenfelder.

Wichtig

Feldverweisnamen können nicht geändert werden. Wenn Sie beispielsweise den Feldnamen "Titel " in "Kopfzeile" ändern, ändert sich der Feldbezugsname dieses Felds nicht. Integrationen und interne Darstellungen von Feldern sollten anstelle des Feldnamens den Feldverweisnamen verwenden.

Beispiele für Feldreferenznamen

Die folgenden Beispiele zeigen gültige Feldverweisnamen in verschiedenen Namespaces.

Beispiele für System-Namespaces Beispiele für Microsoft-Namespaces Weitere Beispiele für Namespaces
System.ID, System.Titel, System.ErstelltVon, System.ErstellungsDatum, System.GeändertVon, System.ÄnderungsDatum, System.Status, System.Grund Microsoft.VSTS.Build.FoundIn, Microsoft.VSTS.Common.Activity, Microsoft.VSTS.Common.Discipline, Microsoft.VSTS.Common.Priority, Microsoft.VSTS.CMMI.TaskType, Microsoft.VSTS.TCM.AutomationStatus, Microsoft.VSTS.TCM.TestSuiteType FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

Contoso.Common.Geschäftspriorität, Contoso.Bug.GefundenInPhase, Contoso.Bug.BehobenInPhase

Hilfetext für das Feld

Das System zeigt Hilfetext zur Laufzeit an, damit Benutzer wissen, was sie in das Feld eingeben müssen. Hilfetexte sind auf einen bestimmten Arbeitselementtyp in einem bestimmten Projekt beschränkt.

Für den Vererbungsprozess geben Sie den Hilfetext für ein Feld über den Dialogfeld Bearbeiten, Registerkarte Definition, Beschreibung an. Siehe Ein benutzerdefiniertes Feld zu einem Arbeitselementtyp hinzufügen. Für den lokalen XML-Prozess geben Sie Hilfetext mithilfe des HELPTEXT Elements an. Siehe Feld für die Arbeitsverfolgung hinzufügen oder ändern.

Der von Ihnen hinzugefügte Hilfetext muss den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 255 Unicode-Zeichen enthalten.

Globale Listen

Beim Definieren von Arbeitselementtypen suchen Sie möglicherweise nach Arbeitselementfeldern, die denselben Satz zulässiger oder vorgeschlagener Werte haben. Eine globale Liste ist eine Gruppe von Listenelementwerten, die Sie einmal definieren und global für alle Projektsammlungen innerhalb einer Instanz von lokalen Azure DevOps-Server verwenden können.

Eine mithilfe des GLOBALLIST Elements definierte globale Liste enthält ein oder mehrere Listenelemente, die mithilfe des LISTITEM Elements angegeben sind. Weitere Informationen finden Sie unter Globale Listen definieren.

Globale Listen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Eindeutigkeit Die globale Liste muss innerhalb der Azure DevOps Server-Instanz eindeutig sein.
Artikelanzahl Darf nicht leer sein. Die globale Liste muss mindestens ein LISTITEM-Element enthalten.

LISTITEM-Namen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge - Darf nicht mehr als 254 Unicode-Zeichen enthalten.
- Darf nicht leer sein.
Sonderzeichen – Darf keinen führenden oder abschließenden Leerraum enthalten.
- Darf keine zwei aufeinanderfolgenden Leerzeichen enthalten.
- Darf nicht das umgekehrte Schrägstrichzeichen \ enthalten.
Bereich Da globale Listen für alle Projekte verfügbar sind, dürfen sie keine Elemente enthalten, die auf Projektebene definiert sind, wie beispielsweise projektspezifische Gruppenkonten-Definitionen.

Definieren Sie einen Verweisnamen, wenn Sie einen Linktyp oder eine Kategorie hinzufügen oder erstellen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 70 Unicode-Zeichen enthalten.
Eindeutigkeit - Darf nicht mit einem anderen Feldverweisnamen innerhalb der Projektsammlung identisch sein.
- Darf nicht mit einem anderen Feldverweisnamen identisch sein, nachdem das System die Namen verarbeitet, um alle Punkte . durch Unterstriche _zu ersetzen. Beispielsweise werden die Feldverweisnamen My._Field und My..Field beide mit demselben Namen verarbeitet: My__Field.
Sonderzeichen - Kann alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte verwenden.
- Darf keine aufeinanderfolgenden Bindestriche -- enthalten.
- Muss mindestens einen Punkt enthalten, kann aber nicht mit einem Punkt beginnen oder enden ..
- Kann nicht mit einer Zahl oder einem Unterstrich _beginnen.

Namen von Arbeitselementabfragen

Sie können Arbeitsaufgabenabfragen verwenden, um Arbeitsaufgaben basierend auf von Ihnen angegebenen Feldkriterien auflisten. Weitere Informationen finden Sie unter "Informationen zu verwalteten Abfragen".

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 255 Unicode-Zeichen enthalten.
Sonderzeichen - Darf nicht leer sein.
- Darf keines der folgenden Zeichen enthalten: /\<>*?"+|:.
Eindeutigkeit - Muss in einem Ordner enthalten sein und innerhalb des Ordners eindeutig benannt werden.

Namen von Arbeitselement-Tags

Arbeitselementtags bestehen aus einem oder zwei Schlüsselwörtern, die Arbeitsverfolgungstools wie Backlogs, Boards und Abfragen filtern oder definieren. Weitere Informationen finden Sie unter Hinzufügen von Arbeitselementtags zum Kategorisieren und Filtern von Listen und Boards.

Tagnamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge - Darf nicht mehr als 400 Unicode-Zeichen enthalten.
- Darf nicht null oder leer sein.
Sonderzeichen - Darf keine Trennzeichen , enthalten oder ;.
- Darf keine Unicode-Steuerelement- oder Formatzeichen wie Zeilenfeeds, Absatztrennzeichen, Wagenrücklauf oder andere nicht übereinstimmende Ersatzzeichen enthalten.

Azure-Pipelines

Azure Pipeline-Objekte müssen den folgenden Benennungseinschränkungen entsprechen.

Objekttyp Einschränkung
Ausdrücke - Muss mit einem kleinen oder großen Buchstaben oder Unterstrich beginnen, gefolgt von kleinen oder großen Buchstaben, Zahlen oder Unterstrichen _.
Variablen - Darf nur alphanumerische Zeichen, Punkte .und Unterstriche _enthalten.
- Kann nicht mit den reservierten Präfixen endpoint, , input, , secret, pathoder , Groß-/ securefileKleinschreibung beginnen.
PHASEN - Der Phasenname darf nur alphanumerische Zeichen und Unterstriche _ enthalten.
- Name darf nicht mit einer Zahl beginnen.
Aufträge und Bereitstellungsaufgaben - Auftragsname darf nur alphanumerische Zeichen und Unterstriche _enthalten.
- Name darf nicht mit einer Zahl beginnen.
- Der Name darf keine Schlüsselwörter wie deploy enthalten.
Matrix-Job-Strategie - Matrixkonfigurationsname darf nur alphanumerische Zeichen und Unterstriche _enthalten.
- Der Name muss mit einem alphabetischen Zeichen beginnen.
- Maximale Länge: 100 Zeichen.
Erstellen einer Ressource - Alias oder Name des Build-Artefakts darf nur alphanumerische Zeichen, Bindestriche -, und Unterstriche _ enthalten.
Containerressourcen - Container-ID darf nur alphanumerische Zeichen, Bindestriche -und Unterstriche _enthalten.
Ressourcen paketieren - Alias für Paket-Artefakt darf nur alphanumerische Zeichen, Bindestriche -, und Unterstriche _ enthalten.
Pipeline-Ressourcen - Pipeline-ID darf nur alphanumerische Zeichen, Bindestriche -und Unterstriche _enthalten.
Ressourcen des Repositories - Repositoryalias dürfen nur alphanumerische Zeichen, Bindestriche -und Unterstriche _enthalten.
Webhook-Ressourcen - Der Webhook-Name darf nur alphanumerische Zeichen, Bindestriche -und Unterstriche _enthalten.
Schritte - Schrittnamen-ID darf nur alphanumerische Zeichen, Bindestriche -und Unterstriche _enthalten.

Weitere Informationen finden Sie in der dokumentation Azure Pipelines.

Azure Repos

Azure Repos-Repositorys können git-basiert oder Team Foundation Version Control (TFVC)-basiert sein.

Jedes Azure DevOps-Projekt kann mehrere Git-Repositorys enthalten. Weitere Informationen finden Sie in der Azure Repos Git-Dokumentation.

Git-Repositorynamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Eindeutigkeit Darf nicht mit einem anderen Git-Repo-Namen im Projekt identisch sein.
Sonderzeichen - Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.
- Darf die folgenden druckbaren Zeichen nicht enthalten: \/:*?"<>;#$*{},+=[]|.
- Darf nicht mit einem Unterstrich beginnen _.
: Darf nicht mit einem Punkt beginnen oder enden ..
- Darf kein vom System reservierter Name sein.
- Wichtig: Obwohl Sie Leerzeichen innerhalb von Repositorynamen einschließen können, wird dies nicht empfohlen.

Informationen zu Benennungseinschränkungen für andere Git-Elemente wie Verzweigungen und Tags finden Sie im Git Check-ref-Format.

Computernamen

Der Computername, auf dem Sie Azure DevOps installieren, wird mit dem Namen des Servers verknüpft. Sowohl das Betriebssystem als auch Active Directory legen bestimmte Einschränkungen für Computernamen fest, wie in den folgenden Artikeln beschrieben:

Team Foundation Build (Buildsystem von Team Foundation)

Mit Team Foundation Build können Sie alle Aspekte des Buildprozesses auf einem einzigen Computer verwalten. Mithilfe von Team Foundation Build können Sie Quellen synchronisieren, die Anwendung kompilieren, zugehörige Komponententests ausführen, Codeanalyse durchführen, Builds auf einem Dateiserver freigeben und Buildberichte veröffentlichen.

Build-Computers

Team Foundation Build ist eine separate Installation, die nicht Teil der Anwendungsebene, Datenebene oder des Visual Studio-Clients von Azure DevOps Server ist. Sie können einen separaten Computer auswählen oder den Build nebeneinander auf dem Clientcomputer oder auf den Servern installieren.

Ihr lokaler Build-Computer muss die folgenden Einschränkungen erfüllen.

Einschränkungstyp Einschränkung
Speicherplatz Muss genügend Speicherplatz für den Build enthalten, da nicht genügend Speicherplatz zu fehlerhaften Builds führt.
Buildverzeichnis Muss ein lokaler Pfad wie C:\BuildDirectory sein.
Ablageortverzeichnis Muss ein UNC-Pfad sein, z. B. \server\share*.
Ablageortberechtigungen Jeder generierte Build muss in einem neuen Verzeichnis im Drop-Ordner abgelegt werden.
- Das Team Foundation Server-Servicekonto, zum Beispiel Domain\TFSSERVICE, muss Vollzugriff auf den UNC-Speicherort haben.
- Der UNC-Ablageort muss ein freigegebener Ordner sein.
Team Foundation Builddienst-Konto Wenn Sie das TFS-Dienstkonto nach der Erstinstallation ändern, müssen Sie folgendes sicherstellen:
- Das Konto ist Mitglied der Gruppe „Builddienste“.
- Das Konto verfügt über Lese-/Schreibberechtigungen für die temporären Ordner und den temporären Ordner von ASP.NET.
– Das Konto verfügt über die Berechtigung "Vollzugriff" für das Buildverzeichnis und den Ablageort.
Firewall Wenn der Buildcomputer firewallfähig ist, stellen Sie sicher, dass sich das Programm tfsbuildservice in der Ausnahmenliste befindet.

Buildtypen

Buildtypen sind die Bedingungen zum Erstellen einer einzelnen Lösung oder einer Reihe von Lösungen in einem Projekt. Zum Ausführen eines Builds können Sie einen neuen Buildtyp erstellen oder einen vorhandenen Buildtyp verwenden.

Buildtypnamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Eindeutigkeit Darf nicht mit einem anderen Build-Typnamen im Projekt identisch sein.
Sonderzeichen Darf das Dollarzeichen $ nicht enthalten.

Buildqualität

Mit der Buildqualität können Sie einem abgeschlossenen Build eine Qualitätsstufe oder einen Fertigstellungsstatus zuweisen. Eine Liste der Standardmäßigen Buildqualitätswerte finden Sie unter Bewerten der Qualität eines abgeschlossenen Builds. Mit Team Foundation Build können Sie auch neue Werte für den Buildqualitäts-Typ erstellen.

Die Namen für die Build-Qualität müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 256 Unicode-Zeichen enthalten.
Eindeutigkeit Darf nicht mit einem anderen Buildqualitätsnamen auf dem Team Foundation Build-Computer übereinstimmen.

Projektsammlungsnamen

Die Projektsammlung ist die Organisationsstruktur, die Sie zum Definieren und Steuern einer Gruppe von Projekten für Azure DevOps Server verwenden. Die Projektsammlung identifiziert eine Gruppe von Projekten und deren Ressourcen. Der Name der Projektsammlung ist auch Teil der Verbindungszeichenfolge, die zum Verbinden von Teammitgliedern mit Projekten verwendet wird.

Der Standardauflistungsname, der einer Projektauflistung zugewiesen ist, entspricht DefaultCollection. Weitere Informationen finden Sie unter Verwalten von Projektsammlungen.

Projektsammlungsnamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Eindeutigkeit - Darf nicht mit einem anderen Namen einer Sammlung in Ihrer lokalen Bereitstellung identisch sein.
- Wenn Ihre Bereitstellung SharePoint-Produkte oder SQL Server Reporting Services enthält, können ihre Namen nicht mit dem Namen und vollständigen Pfad einer vorhandenen SharePoint-Website, eines Berichtsservers oder einer Reporting Services-Website identisch sein.
Sonderzeichen - Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.
- Darf die folgenden druckbaren Zeichen nicht enthalten: \/:*?"<>;#$*{},+=[]|.
- Darf keine Auslassungspunkte ... oder einen doppelten Punkt .. enthalten.
- Darf nicht mit einem Unterstrich beginnen _.
: Darf nicht mit einem Punkt beginnen oder enden ..
Darf kein vom System reservierter Name sein.

Organisationsnamen

Die Organisation ist die Organisationsstruktur, die Sie zum Definieren und Steuern einer Gruppe von Projekten für Azure DevOps Services verwenden. Die Organisation identifiziert eine Gruppe von Projekten und deren Ressourcen.

Wichtig

Befolgen Sie die folgenden Richtlinien, wenn Sie ihren Organisationsnamen erstellen:

  • Verwenden Sie nur Buchstaben aus dem englischen Alphabet.
  • Beginnen Sie den Namen Ihres Unternehmens mit einem Buchstaben oder einer Zahl.
  • Verwenden Sie nach dem ersten Zeichen Buchstaben, Zahlen oder Bindestriche.
  • Beibehalten des Namens Ihrer Organisation unter 50 Unicode-Zeichen
  • Mit einem Buchstaben oder einer Zahl enden

Wenn Sie unzulässige Zeichen verwenden, wird die folgende Fehlermeldung angezeigt: VS850015: Der angegebene Name darf nicht verwendet werden: {Organisationsname}.

Prozess und Prozessvorlagen

Ein Prozess definiert die Bausteine des Nachverfolgungssystems für Arbeitsaufgaben und andere Subsysteme, auf die Sie nach dem Herstellen einer Verbindung mit einem Projekt zugreifen können. Sowohl Prozess - als auch Prozessvorlage beziehen sich auf einen zusammenhängenden Satz von Dateien, die zum Erstellen eines Projekts verwendet werden. Informationen zu den Standardprozessen finden Sie unter "Informationen zu Prozessen und Prozessvorlagen".

Von Ihnen definierte oder angepasste Prozesse müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 256 Unicode-Zeichen enthalten.
Eindeutigkeit – Muss in ganz Azure DevOps einzigartig sein. Wenn Sie eine Vorlage mit demselben Namen wie eine vorhandene Vorlage hochladen, wird die vorhandene Vorlage überschrieben.
Dateigröße der Prozessvorlage Darf 2 Gigabyte nicht überschreiten.

Projektnamen

Ein Projekt richtet ein Repository für Quellcode ein und schafft einen Ort, an dem Teams planen, Fortschritte verfolgen und zusammenarbeiten können. Der Name des Projekts ist Teil der Verbindungszeichenfolge, die verwendet wird, um Teammitglieder mit Projekten zu verbinden.

Die Namen, die Sie den von Ihnen erstellten Projekten zuweisen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Eindeutigkeit Darf nicht mit einem anderen Namen in der Organisation, der Projektsammlung oder der SharePoint-Webanwendung oder dem SQL Server-Bericht für die Auflistung identisch sein.
Reservierte Namen - Darf kein vom System reservierter Name sein.
- Darf keins der ausgeblendeten Segmente sein, die für die IIS-Anforderungsfilterung verwendet werden, wie App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin oder web.config.
Sonderzeichen - Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.
- Darf die folgenden druckbaren Zeichen nicht enthalten: \/:*?"'<>;#$*{},+=[]|.
- Darf nicht mit einem Unterstrich beginnen _.
: Darf nicht mit einem Punkt beginnen oder enden ..

Sicherheitsgruppen

Sie können Azure DevOps-Sicherheitsgruppen verwenden, um bestimmte Rechte oder Berechtigungen auf eine Gruppe von Benutzern anzuwenden. Gruppen können aus Microsoft Entra-ID- oder Active Directory-Konten, Azure DevOps-Sicherheitsgruppen, Windows-Benutzer- oder Gruppenkonten oder einer Kombination bestehen. Weitere Informationen finden Sie unter Active Directory-/Microsoft Entra-Benutzer oder -Gruppen zu einer integrierten Sicherheitsgruppe hinzufügen.

Sicherheitsgruppen müssen die folgenden Einschränkungen einhalten.

Einschränkungstyp Einschränkung
Länge des Kontonamens der Sicherheitsgruppe Darf nicht mehr als 256 Unicode-Zeichen enthalten.
Eindeutigkeit - Projektbezogene Gruppenkonten dürfen nicht mit anderen Gruppennamen im selben Projekt übereinstimmen.
- Gruppenkonten auf Organisation oder Sammlungsebene dürfen keinem anderen Namen eines Gruppenkontos in der Organisation oder Projektsammlung entsprechen.
Reservierte Gruppennamen Darf weder auf Projekt- noch auf Serverebene mit einem $NAMESPACE benannt werden.
Sonderzeichen - Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.
- Darf die folgenden druckbaren Zeichen nicht enthalten: ,/\[]:<>+=;?*|.
- Darf keine nicht druckbaren Zeichen im ASCII-Wertebereich von 1 bis 31 enthalten.
- Darf nicht mit einem Punkt enden ..

Teamnamen

Teamnamen identifizieren eine Gruppe von Einzelpersonen oder Gruppen, die als Team in einem Projekt zusammenarbeiten. Teammitglieder verwenden diesen Namen, um sich mit dem Team zu verbinden oder Abfragen an für ein Team definierte Mitglieder zu stellen. Teamnamen müssen Konventionen entsprechen, die das Rendern als Teil einer gültigen URL ermöglichen.

Jeder Teamname muss innerhalb eines einzelnen Projekts eindeutig sein, aber es gibt keine Einschränkungen für die Verwendung desselben Teamnamens in verschiedenen Projekten innerhalb einer Organisation oder Projektsammlung. Weitere Informationen finden Sie unter Hinzufügen eines weiteren Teams oder einer Teamhierarchie.

Teamnamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Eindeutigkeit Darf nicht mit einem anderen Teamnamen im Projekt identisch sein.
Reservierte Namen Darf kein vom System reservierter Name sein.
Sonderzeichen - Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.
- Darf die folgenden druckbaren Zeichen nicht enthalten: \/:*?"<>;#$*{},+=[]|.
- Darf keine Auslassungspunkte ... oder einen doppelten Punkt .. enthalten.
- Darf nicht mit einem Unterstrich beginnen _.
: Darf nicht mit einem Punkt beginnen oder enden ..

Benutzerkontennamen

Benutzerkonten identifizieren Benutzer, die zu einem Projekt oder einer Projektsammlung hinzugefügt wurden. Benutzerkonten entsprechen möglicherweise Einträgen innerhalb von Active Directory, Microsoft Entra ID oder Windows Server-Gruppe.

Weitere Informationen, um Benutzerkonten zu einem Projekt hinzuzufügen, finden Sie unter Benutzer zu einem Projekt oder Team hinzufügen. Benutzerkonten, die Sie zu einem Unternehmen oder einer Sammlung hinzufügen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Länge des Kontonamens Darf nicht mehr als 256 Unicode-Zeichen enthalten.
Eindeutigkeit Darf keinem anderen Benutzerkonto in der Organisation oder Projektsammlung entsprechen.
Reservierte Gruppennamen Darf weder auf Projekt- noch auf Serverebene mit einem $NAMESPACE benannt werden.
Sonderzeichen - Darf die folgenden druckbaren Zeichen nicht enthalten: ,"/\[]:<>+=;?*|.
- Darf keine nicht druckbaren Zeichen im ASCII-Wertbereich von 1-31 enthalten.
- Darf nicht mit einem Punkt . oder einem Dollarzeichen $ enden.
- Darf nicht die folgenden Unicode-Kategorien enthalten: LineSeparator, , ParagraphSeparator, Control, Format. OtherNotAssigned

Wiki-Seite und Dateinamen

Jede Wiki-Seite entspricht einer Datei im Wiki-Git-Repository. Die folgenden Einschränkungen gelten für Seitendateinamen und die Dateigröße:

  • Dateiname: Beachten Sie beim Auswählen eines Namens für die Seitendatei, dass der vollqualifizierte Pfad zur Datei 235 Zeichen oder weniger sein sollte. Der vollständige Pfad zur Seite besteht aus der Repository-URL, dem Ordnerpfad zur Seitendatei und dem Seitendateinamen. Beispiel: https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.

  • Eindeutigkeit: Der Name der Seitendatei muss innerhalb des Ordnerspeicherorts in der Wiki-Repositoryhierarchie eindeutig sein. Bei dem Namen wird zwischen Groß- und Kleinschreibung unterschieden.

  • Sonderzeichen: Der Dateiname der Seite hat Einschränkungen für die folgenden Sonderzeichen:

    • Keine Unicode-Steuerzeichen oder Ersatzzeichen
    • Keine druckbaren Zeichen: Schrägstrich /, Backslash \, Hash #
    • Kein Punktzeichen . am Anfang oder am Ende des Namens

  • Dateigröße: Die maximale Seitendateigröße beträgt 18 MB.

  • Größe der Anlagendatei: Die maximale Größe einer Anlage einer Seitendatei beträgt 19 MB.

Zulässige Sonderzeichen

In einem Seitendateinamen sind mehrere Sonderzeichen zulässig, z. B. Doppelpunkt : und Bindestrich -. Sie können beispielsweise eine Markdown-Datei als FAQ:0525 oder Setup-Guide benennen.

Wichtig

Um Fehler in seitensyntax und browsernavigation zu vermeiden, verwenden Sie nicht das Leerzeichen ( ) in Seitendateinamen. Wenn Sie Ihre Seitendateien basierend auf dem Seitentitel benennen, ersetzen Sie alle Leerzeichen im Seitentitel durch einen Bindestrich (-) im Dateinamen.

In der folgenden Tabelle sind die in Wiki-Seitendateinamen zulässigen Sonderzeichen und die entsprechende URI-codierte Zeichenfolge aufgeführt:

Zeichen Symbol URI-Zeichenfolge
Doppelpunkt : %3A
Linke eckige Klammer < %3C
Rechte eckige Klammer > %3E
Sternchen (Wildcard) * %2A
Fragezeichen ? %3F
Pipe | %7C
Bindestrich (Gedankenstrich) - %2D
Doppeltes Anführungszeichen " %22

Beispielsweise wird der Dateiname FAQ:0525 als FAQ%3A0525codiert.

Verwandte Inhalte

  • Last updated on