Freigeben über

Benennungseinschränkungen und -konventionen

  • Artikel

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

Die meisten Komponenten in Azure DevOps müssen Benennungseinschränkungen und Konventionen einhalten. Einschränkungen tragen dazu bei, eine konsistente Benutzererfahrung zu gewährleisten und Kompatibilität mit anderen Anwendungen bereitzustellen.

Allgemeine Einschränkungen umfassen, dass die Zeichenlänge für einen Namen nicht überschritten wird, keine Sonderzeichen enthalten und die Eindeutigkeit von Namen in einem Objektsatz beibehalten wird.

Wichtig

Wenn Sie die API anstelle der Benutzeroberfläche (Ui) verwenden, können Sie mit der API direkt einen Namen angeben, der Zeichen enthält, die in der Benutzeroberfläche möglicherweise eingeschränkt sind.

Bewährte Methoden:

  • Befolgen Sie die Ui-Einschränkungen, um Konsistenz zu gewährleisten und unbeabsichtigte Probleme zu verhindern.
  • Überprüfen Sie Namen programmgesteuert, und behandeln Sie alle Sonderzeichen entsprechend.

Allgemeine Hinweise

Die Längenbeschränkungen in diesem Artikel werden anhand der zulässigen Anzahl von Unicode-Zeichen gemessen. Ersatzzeichen bestehen aus zwei Unicode-Zeichen, die als zwei Zeichen für die Längeneinschränkung zählen. Weitere Informationen finden Sie unter "Informationen zu Unicode- und Zeichensätzen".

Wie bei anderen Betriebssystemdateien sind ASCII-Steuerzeichen (ASCII 1-31) und Ersatzkombinationen ebenfalls nicht zulässig. Allgemeine Informationen zu den Betriebssystemeinschränkungen, die auf Dateinamen angewendet werden, finden Sie unter Namensdateien, Pfade und Namespaces.

Hinweis

Reservierte Systemnamen

Vermeiden Sie die Verwendung reservierter Systemnamen, z. B. 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 Pakete müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Paketname - Muss Kleinbuchstaben sein.
- Muss mit Buchstaben oder Zahlen beginnen und enden.
- Darf nur Buchstaben, Zahlen und nicht zusammenhängende Striche, Unterstriche oder Punkte enthalten.
Paketversion Muss ohne Buildmetadaten klein geschrieben sein.

Azure Boards

Sie verwenden Arbeitsaufgaben, um Informationen zu erfassen, um Ihre Softwareentwicklungsprojekte zu planen und nachzuverfolgen. Mit Arbeitsaufgaben können Sie die zu erledigende Arbeit beschreiben, Arbeit zuweisen, Status nachverfolgen und Bemühungen innerhalb Ihres Teams koordinieren. 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.

Alle Nachverfolgungsobjekte für Arbeitsaufgaben sind einem oder mehreren Namen zugeordnet. Die meisten weisen Anzeigenamen mit Ausnahme von Arbeitsaufgabentypen und globalen Listen auf, die Referenznamen zugeordnet sind. Ein Anzeigename ist ein eindeutiger, benutzerdefinierter Bezeichner für ein Feld. Die Verwendung von Anzeigenamen sorgt für Konsistenz zwischen Projekten und Arbeitsaufgabentypen in einer Projektsammlung. Das System verwendet den Verweisnamen intern, und Sie können ihn nach der Definition nicht mehr ändern.

Es gibt Einschränkungen für mehrere Elemente, die Arbeitsaufgaben zugeordnet sind, einschließlich Verweis- und Anzeigenamen, Feldnamen und Anlagengröße.

Bereichs- und Iterationspfade

Zwei Arbeitsaufgabenfelder, Bereichspfad und Iterationspfad, stellen eine Strukturstrukturhierarchie für die Gruppierung von Arbeiten bereit. Bereichspfade gruppieren Arbeitsaufgaben nach Produkt-, Funktions- oder Featurebereich. Iterationspfade gruppieren Arbeitsaufgaben in Sprints, Meilensteine oder Zeiträume für die Adressierung dieser Arbeitsaufgaben.

Diese Felder mit mehreren Knoten verwenden die umgekehrten Schrägstriche \ , um die Hierarchie von Knoten innerhalb der Struktur zu kennzeichnen.

Die Namen, die Sie diesen Feldern untergeordneten Knoten 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

Dateien, die an Arbeitsaufgaben angefügt sind, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Dateigröße Darf die maximale Größe nicht überschreiten:
- Maximale Standardgröße: 4.096 KB.
- Absolute maximale Größe: 2 Gigabyte.
Einschränkungstyp Einschränkung
Dateigröße Darf die maximale Größe nicht überschreiten:
- Maximale Standardgröße: 4.096 KB.
- Absolute maximale Größe: 2 Gigabyte. Weitere Informationen finden Sie unter Ändern der maximalen Anlagengröße für Arbeitsaufgaben.

Boardspalten- und Verantwortlichkeitsbereichsnamen

Ihr Board wandelt Ihren Backlog in ein interaktives Signboard um und bietet einen visuellen Arbeitsfluss. Während die Arbeit von der Idee bis zur Fertigstellung voranschreitet, aktualisieren Sie die Elemente auf dem Board. Jede Spalte stellt eine Arbeitsphase dar, und jede Karte repräsentiert eine User Story (blaue Karten) oder einen Fehler (rote Karten) in dieser Arbeitsphase.

Passen Sie Ihr Board an, indem Sie Spalten und Verantwortlichkeitsbereiche hinzufügen, entfernen oder umbenennen. Spalten unterstützen den Arbeitsfluss über das Board hinweg. Verantwortlichkeitsbereiche ermöglichen es Ihnen, verschiedene Arbeitsklassen als horizontale Spur auf dem Board zu verwalten.

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

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 256 Unicode-Zeichen enthalten.
Eindeutigkeit - Spaltennamen dürfen nicht mit anderen Spaltennamen auf der Tafel identisch sein.
- Verantwortlichkeitsbereichsnamen dürfen nicht mit anderen Verantwortlichkeitsbereichsnamen auf der Tafel identisch sein.
Sonderzeichen Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.

Feldnamen

Jeder Arbeitsaufgabentyp enthält ein oder mehrere Arbeitsaufgabenfelder. Diese Felder definieren die für Arbeitsaufgaben gespeicherten Informationen basierend auf dem Arbeitsaufgabentyp. Jedes Arbeitselementfeld weist einen zugeordneten Feldverweisnamen auf. Der Feldbezugsname identifiziert jedes Feld eindeutig und kann nicht mehr geändert werden, sobald es zugewiesen wurde. Weitere Informationen zu vordefinierten Arbeitsaufgabenfeldern finden Sie unter Arbeitselement-Feldindex.

Feldnamen für Arbeitsaufgaben müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 128 Unicode-Zeichen enthalten.
Eindeutigkeit - Feldnamen müssen mindestens ein alphabetisches Zeichen enthalten.
- Darf keines der folgenden Zeichen enthalten: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.
- Darf keine führenden oder nachgestellten Leerzeichen enthalten.
- Darf keine zwei oder mehr aufeinander folgenden Leerzeichen enthalten.
Sonderzeichen Muss innerhalb der Organisation oder Projektsammlung eindeutig sein. Feldnamen für Arbeitsaufgaben sind auf die Projektauflistung angewendet. Wenn Sie einen Feldnamen umbenennen, ändern Sie ihn für alle Arbeitsaufgaben und WITs, die in allen Projekten in der Auflistung definiert sind.

Feldbezugsnamen und Portabilität

Die Definitionssprache für Arbeitsaufgabentypen enthält das Konzept eines Feldverweisnamens. Feldverweisnamen können Ihnen dabei helfen, Definitionen zwischen Team Foundation-Projektsammlungen zu portieren und auch Nicht-Microsoft-Integrationen zu ermöglichen, bestimmte Felder zu suchen und auf sie zu verweisen. Diese Namen sind global eindeutig, ebenso wie ein Namespace in der .NET Framework-Anwendung global eindeutig ist.

Der Systemnamespace wird nur verwendet, um alle Kernsystemfelder zu definieren, die für Team Foundation-Systemfunktionen obligatorisch sind. Sie können kein eigenes System.X-Feld erstellen, da die Funktionalität möglicherweise beeinträchtigt wird.

Der Microsoft-Namespace wird verwendet, um Nachverfolgungsfelder für Arbeitsaufgaben zu definieren. Diese Felder werden in einer Arbeitsaufgabentypdefinition der Prozessvorlagen definiert.

Kunden und Partner können eigene Feldnamespaces für benutzerdefinierte Arbeitsaufgabentypen erstellen. Beschreibungen von Systemfeldern und Feldern, die in den Standardprozessvorlagen definiert sind, finden Sie unter Index der Arbeitsaufgabenfelder.

Wichtig

  • Feldverweisnamen können nicht umbenannt werden. Wenn Sie beispielsweise den Feldnamen "Title" in "Header" geändert haben, bleibt der Feldbezugsname dieses Felds identisch. Integrationen und interne Darstellungen von Feldern sollten den Feldverweisnamen anstelle des Feldnamens selbst verwenden.
  • Obwohl Sie Ihr eigenes Microsoft.X-Feld erstellen können, empfehlen wir dies nicht, da dies die Funktionalität beeinträchtigen kann, oder die Möglichkeit, dass der Assistent "Features konfigurieren" nach einem Upgrade ein Projekt erfolgreich aktualisieren kann.

Beispiele für Feldverweisnamen

Die folgenden Beispiele zeigen gültige Feldverweisnamen in verschiedenen Namespaces. Kunden und Partner können auch eigene Namespaces definieren, um ihre benutzerdefinierten Arbeitsaufgabentypen zu unterstützen.

Beispiele für Systemnamespaces Microsoft-Namespacebeispiele Weitere Namespacebeispiele
System.Id, System.Title, System.CreatedBy, System.CreatedDate, System.ChangedBy, System.ChangedDate, System.State, System.Reason 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 Das fiktive Unternehmen Fabrikam Fiber kann die folgenden benutzerdefinierten Arbeitsaufgabenfelder definieren:
FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution

Das fiktive Softwareunternehmen Contoso Corporation kann die folgenden Arbeitsaufgabenfelder definieren:
Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase

Feldhilfetext

Das System zeigt Hilfetext zur Laufzeit an, damit Benutzer wissen, was in das Feld eingegeben werden soll. Der Hilfetext ist auf einen bestimmten Arbeitsaufgabentyp in einem bestimmten Projekt festgelegt.

Für den Vererbungsprozess geben Sie Hilfetext für ein Feld über das Dialogfeld "Feld bearbeiten", Registerkarte "Definition " und "Beschreibung" an. Siehe Hinzufügen eines benutzerdefinierten Felds zu einem Arbeitsaufgabentyp. Für den lokalen XML-Prozess geben Sie Hilfetext mithilfe des HELPTEXT Elements an. Siehe Hinzufügen oder Ändern eines Felds für die Nachverfolgung von Arbeiten.

Hilfetext, den Sie hinzufügen, muss den folgenden Einschränkungen entsprechen.

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

Globale Listen

Eine globale Liste ist eine Gruppe von Listenelementwerten, die Sie global für alle Projektsammlungen innerhalb einer Instanz eines lokalen Azure DevOps-Servers verwenden können. Während Sie Arbeitsaufgabentypen definieren, stellen Sie möglicherweise fest, dass einige Arbeitsaufgabenfelder denselben Satz zulässiger oder vorgeschlagener Werte gemeinsam verwenden. Mit globalen Listen können Sie diese Werte einmal definieren und für mehrere Arbeitsaufgabentypen und Projekte freigeben. Ausführliche Informationen finden Sie unter Definieren globaler Listen.

Eine mithilfe des GLOBALLIST Elements definierte globale Liste enthält ein oder mehrere Listenelemente, die mithilfe des LISTITEM Elements angegeben werden.

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

Einschränkungstyp Einschränkung
Length - Darf nicht mehr als 254 Unicode-Zeichen enthalten.
- Darf nicht leer sein.
Sonderzeichen - Darf kein führendes oder nachfolgendes Leerzeichen enthalten.
- Darf keine zwei aufeinander folgenden Leerzeichen enthalten.
- Darf keine umgekehrten Schrägstriche \ enthalten.
`Scope` Da globale Listen unter allen Projekten verfügbar sind, dürfen sie keine Elemente enthalten, die auf Projektebene definiert sind, z. B. projektspezifische Gruppenkontodefinitionen.

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

Einschränkungstyp Einschränkung
Artikelanzahl Darf nicht leer sein. Die globale Liste muss mindestens ein LISTITEM Element enthalten.
Eindeutigkeit Darf nicht leer sein. Die globale Liste muss mindestens ein LISTITEM Element enthalten.

Definieren Sie einen Verweisnamen, wenn Sie einen Linktyp oder eine Kategorie hinzufügen oder erstellen. Alle Verweisnamen können bis zu 70 Unicode-Zeichen lang sein.

Definieren Sie einen Verweisnamen mithilfe alphanumerischer Zeichen, Unterstrichzeichen und Bindestriche. Jeder Verweisname muss mindestens einen Punkt .enthalten, aber es kann kein Punkt am Anfang oder Ende eines Namens angezeigt werden. Ein Verweisname darf nicht mit einer Zahl oder einem Unterstrich beginnen, und er darf nicht mehrere aufeinander folgende Bindestriche aufweisen, z --. B. .

Einschränkungstyp Einschränkung
Length 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 diese Namen vom Computer verarbeitet wurden, um alle Punkte . durch Unterstriche _zu ersetzen. Beispielsweise werden die Feldverweisnamen My.*Field* My.Field und beide mit demselben Namen verarbeitet: My__Field
Sonderzeichen - Darf keine Bindestriche -enthalten.
- Muss mindestens einen Punkt .enthalten.
: Darf nicht mit einem Punkt beginnen oder enden ..
- Darf nicht mit einem numberMust beginnen mit einem Unterstrich _.

Arbeitsaufgabentags

Arbeitselementtags entsprechen einem oder zwei Stichwortausdrücken, um Arbeitsverfolgungstools wie Backlogs, Boards und Abfragen zu filtern oder Abfragen zu definieren. Weitere Informationen finden Sie unter Hinzufügen von Arbeitsaufgabentags zum Kategorisieren und Filtern von Listen und Boards.

Tagnamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length - 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 enthalten, z. B. Zeilenvorschub, Absatztrennzeichen, Wagenrücklauf oder andere nicht übereinstimmende Ersatzzeichen.
`Scope` Da globale Listen unter allen Projekten verfügbar sind, dürfen sie keine Elemente enthalten, die auf Projektebene definiert sind, z. B. projektspezifische Gruppenkontodefinitionen.

Azure Pipelines

Azure-Pipelinedefinitionen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Auftragsname - Darf nur alphanumerische Zeichen und '_'.
- Darf nicht mit einer Zahl beginnen.
- Muss einen eindeutigen Namen haben.
- Darf keine Schlüsselwörter enthalten, z. B. "Bereitstellung".
Name der Stufe - Darf nur alphanumerische Zeichen und '_'.
- Darf nicht mit einer Zahl beginnen.
- Darf keine Schlüsselwörter enthalten, z. B. "Bereitstellung".
Ausdrücke Muss mit a-Z oder _AND, gefolgt von a-Z, , 0-9oder _.

Weitere Informationen finden Sie in der Dokumentation zu Azure Pipelines.

Azure Repos (Git)

Jedes Azure DevOps-Projekt kann mehrere Git-Repositorys enthalten. Die Namen, die Sie Git-Repositorys zuweisen, müssen den folgenden Einschränkungen entsprechen. Weitere Informationen finden Sie in der Azure Repos Git-Dokumentation. Weitere Informationen zu Benennungseinschränkungen für andere Git-Elemente wie Verzweigungen und Tags finden Sie im Git-Check-ref-Format.

Wichtig

Obwohl Sie Leerzeichen innerhalb von Repositorynamen einschließen können, wird dies nicht empfohlen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Eindeutigkeit Darf nicht mit einem anderen Git-Repositorynamen 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 reservierter Systemname sein.

Azure Repos (TFVC)

Team Foundation Version Control (TFVC) stellt ein zentrales Repository für Dateien und die Befehle bereit, die zum Verwalten dieser Dateien in einem Team erforderlich sind. Sie bietet außerdem anpassbare Check-In-Richtlinien, Verzweigungen, Zusammenführungen, Regale und viele andere Features. Weitere Informationen finden Sie in der Dokumentation zu Azure Repos TFVC

Versionssteuerungspfade müssen den folgenden Einschränkungen entsprechen. Siehe auch Optimieren Ihres Arbeitsbereichs.

Einschränkungstyp Einschränkung
Pfadlänge des Ordnerpfads für die Serverquellverwaltung - Darf nicht mehr als 259 Unicode-Zeichen für einen einzelnen Ordner oder Dateinamen enthalten.
- Darf nicht mehr als 388 Unicode-Zeichen für ein Verzeichnis enthalten.
- Darf nicht mehr als 399 Unicode-Zeichen für ein kombiniertes Verzeichnis und dateinamen enthalten.
Länge des lokalen Ordnerpfads - Darf nicht mehr als 248 Unicode-Zeichen für ein Verzeichnis enthalten.
- Darf nicht mehr als 260 Unicode-Zeichen für ein kombiniertes Verzeichnis und dateinamen enthalten.
Webportal- und REST-spezifische Längenbeschränkungen Darf nicht mehr als 215 Unicode-Zeichen für einen kombinierten Projektnamen, Verzeichnis und Dateinamen enthalten.

Im Webportal und der REST-API weisen bestimmte Vorgänge eine restriktivere Pfadlänge auf als Visual Studio und TF.exe Clients. Zu diesen Vorgängen gehören "Bearbeiten", "Umbenennen" und "Löschen" und "Löschen", da das Webportal/REST einen zufällig generierten Arbeitsbereich für die Parallelität verwendet, wenn die Änderungen ausstehen.

TFVC-Dateien

Das Versionssteuerungssystem speichert viele verschiedene Dateitypen. Das Einrichten der Team Foundation-Versionssteuerung auf Ihrem Entwicklungscomputer enthält Details zum Hinzufügen vorhandener Visual Studio-Projekte oder -Lösungen.

Dateien und Ordner, die Sie zur Versionskontrolle von Team Foundation hinzufügen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Dateien und Ordner - Namen dürfen nicht die folgenden druckbaren Zeichen enthalten: \ / : * ? " < > ;.
– Ordner dürfen sich nicht außerhalb des zugeordneten Verzeichnisses für den aktiven Arbeitsbereich befinden.
Dateinamen - Darf nicht mit einem $.
- Darf die folgenden druckbaren Zeichen nicht enthalten: \ / : * ? " < > ; |.

TFVC-Bezeichnungen

Im Team Foundation-Versionssteuerelement (TFVC) ist eine Bezeichnung ein Name, der auf einen bestimmten Satz von Überarbeitungen angewendet wird. Sie können Bezeichnungen an eine Reihe nicht verwandter Dateien in der Versionssteuerung anfügen, mit der Sie die Dateien abrufen oder als Gruppe darauf reagieren können. In der folgenden Tabelle werden die Einschränkungen beschrieben, die auf Bezeichnungsnamen angewendet werden.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Sonderzeichen - Kann nicht mit einem Leerzeichen ( ) oder punkt .enden.
- Darf die folgenden druckbaren Zeichen nicht enthalten: \ / : * ? " < > ; @ |.

TFVC-Regale

Regale ermöglichen es Ihnen, vorübergehend eine Reihe ausstehender Änderungen aufzuheben und dann als Option die ausstehenden Änderungen aus Ihrem Arbeitsbereich zu entfernen. Später können Sie die Änderungen in einem Regalet in Ihrem Arbeitsbereich wiederherstellen oder in den Arbeitsbereich eines anderen Benutzers einfügen.

Regalenamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Sonderzeichen Darf die folgenden druckbaren Zeichen nicht enthalten: \ / : * ? " < > & ; |.

TFVC-Arbeitsbereiche

Ein Arbeitsbereich ist eine clientseitige Kopie der Dateien und Ordner im Team Foundation-Versionssteuerelement (TFVC). Wenn Sie mehrere Arbeitsbereiche erstellen, können Sie über unterschiedliche Versionen desselben Versionssteuerungsordners auf einem Clientcomputer verfügen. Erstellen und Arbeiten mit Arbeitsbereichen bieten weitere Details.

Arbeitsbereichsnamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Sonderzeichen - Darf nicht mit einem Leerzeichen ( )enden.
- Darf die folgenden druckbaren Zeichen nicht enthalten: \ / : * ? " < > ; |.

Computernamen

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

Organisationsnamen

Wichtig

Beachten Sie beim Erstellen eines Organisationsnamens die folgenden Richtlinien.

  • Verwenden sie nur Buchstaben aus dem englischen Alphabet
  • Starten Des Namens Ihrer Organisation mit einem Buchstaben oder einer Nummer
  • Verwenden von Buchstaben, Zahlen oder Bindestrichen nach dem Anfangszeichen
  • Stellen Sie sicher, dass Ihre Organisation 50 Unicode-Zeichen nicht überschreitet
  • Enden mit einem Buchstaben oder einer Zahl

Wenn Sie eines der unzulässigen 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.

Hinweis

Terminologie: Sowohl "Prozess" als auch "Prozessvorlage" beziehen sich auf einen zusammenhängenden Satz von Dateien, die zum Erstellen eines Projekts verwendet werden. Weitere Informationen finden Sie unter "Informationen zu Prozessen und Prozessvorlagen", die die Unterschiede zwischen den drei für Sie verfügbaren Standardprozessen beschreiben.

Prozesse, die Sie definieren oder anpassen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 256 Unicode-Zeichen enthalten.
Eindeutigkeit – Muss in Azure DevOps eindeutig sein.
- Wenn Sie eine Vorlage mit demselben Namen wie eine vorhandene Vorlage hochladen, wird die vorhandene Vorlage überschrieben.
Prozessvorlagendateigröße Darf 2 GB (Gigabyte) nicht überschreiten.

Projektsammlungen

Eine Projektsammlung identifiziert eine Gruppe von Projekten und die Ressourcen, die diesen Projekten zugeordnet sind. Es stellt eine Organisationsstruktur bereit, mit der Sie eine Gruppe von Projekten definieren und steuern können, die für einen Azure DevOps-Server definiert sind.

Außerdem ist der Sammlungsname Teil der Verbindungszeichenfolge verwendet, um Teammitglieder mit Projekten zu verbinden. Der zugewiesene Standardwert entspricht "DefaultCollection". Das Verwalten von Projektsammlungen bietet weitere Informationen.

Namen, die Sie Projektsammlungen zuweisen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Eindeutigkeit - Darf nicht mit einem anderen Sammlungsnamen in Ihrer lokalen Bereitstellung identisch sein.
– Wenn Ihre Bereitstellung SharePoint-Produkte oder SQL Server Reporting Services enthält, können sie nicht mit dem Namen und vollständigen Pfad einer vorhandenen SharePoint-Website, eines Berichtsservers oder einer Reporting Services-Website identisch sein.
Reservierte Namen Darf kein reservierter Systemname 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 ..

Projektnamen

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

Namen, die Sie Projekten zuweisen, die Sie erstellen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Eindeutigkeit Darf nicht mit einem anderen Namen in der Projektsammlung, der SharePoint-Webanwendung, die die Auflistung unterstützt, oder mit der Instanz von SQL Server Reporting Services identisch sein, die die Auflistung unterstützt.
Reserviert Namen - Darf kein reservierter Systemname sein.
– Darf keines der ausgeblendeten Segmente sein, die für die IIS-Anforderungsfilterung wie App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin oder web.config verwendet werden.
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

Mit Azure DevOps-Sicherheitsgruppen können Sie bestimmte Rechte oder Berechtigungen auf eine Gruppe von Benutzern anwenden.

Lokale Gruppen können aus Active Directory-Gruppenkonten, Azure DevOps-Sicherheitsgruppen, Windows-Benutzerkonten, Windows-Gruppenkonten, Windows-Gruppenkonten oder einer Mischung dieser Typen bestehen. Weitere Informationen finden Sie unter Hinzufügen von Active Directory/Microsoft Entra-Benutzern oder -Gruppen zu einer integrierten Sicherheitsgruppe.

Sicherheitsgruppen müssen den folgenden Einschränkungen entsprechen.

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

Team Foundation Build

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

Erstellen eines Computers

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

Ihr lokaler Buildcomputer muss den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Speicherplatz Muss genügend Speicherplatz für den Build enthalten (unzureichender Speicherplatz führt zu fehlerhaften Builds).
Buildverzeichnis Muss ein lokaler Pfad sein (z. B C:\BuildDirectory. ).
Speicherortverzeichnis Muss ein UNC-Pfad sein (z. B \server\share. ).
Berechtigungen für Speicherorte Jeder generierte Build wird in einem neuen Verzeichnis im Drop-Ordner abgelegt.
– Das Team Foundation Server Service-Konto (z. B Domain\TFSSERVICE. ) muss über Vollzugriff auf den UNC-Speicherort verfügen.
– Der UNC-Speicherort muss ein freigegebener Ordner sein.
Team Foundation Build Service-Konto Wenn Sie das TFS-Dienstkonto nach der Erstinstallation ändern, müssen Sie sicherstellen, dass die folgenden Bedingungen erfüllt sind:
- Das Konto ist Mitglied der Gruppe "Build Services".
– Das Konto verfügt über Lese-/Schreibberechtigungen für die temporären Ordner und den ASP.NET temporären Ordner.
– Das Konto verfügt über die Berechtigung "Vollzugriff" für das Buildverzeichnis und den Speicherort.
Firewallprobleme Wenn der Buildcomputer firewallfähig ist, stellen Sie sicher, dass sich das Programm tfsbuildservice in der Ausnahmenliste befindet.

Buildtypen

Buildtypen konfigurieren die Bedingungen, unter denen eine einzelne Lösung oder eine Reihe von Lösungen in einem Projekt erstellt werden. Um einen Build durchzuführen, müssen Sie entweder 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 Buildtypnamen im Projekt identisch sein.
Sonderzeichen Darf nicht das folgende druckbare Zeichen enthalten: $.

Buildqualität

Mit der Buildqualität können Sie einen Qualitätsstufen- oder Abschlussstatus an einen abgeschlossenen Build anfügen. Mit Team Foundation Build können Sie auch neue Werte für den Buildqualitätstyp erstellen. Weitere Informationen finden Sie unter "Bewerten der Qualität eines abgeschlossenen Builds für eine Liste der Standardmäßigen Buildqualitätswerte".

Buildqualitätsnamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 256 Unicode-Zeichen enthalten.
Eindeutigkeit Darf nicht mit einem anderen Buildqualitätsnamen auf dem Team Foundation Build-Computer identisch sein.

Teamnamen

Teamnamen identifizieren eine Gruppe von Einzelpersonen oder Gruppen, die gemeinsam als Team in einem Projekt zusammenarbeiten. Teammitglieder verwenden diesen Namen, um eine Verbindung mit dem Team herzustellen oder um für ein Team definierte Mitglieder abzufragen.

Teamnamen müssen Konventionen entsprechen, mit denen sie als Teil einer gültigen URL gerendert werden können. Jeder Teamname muss innerhalb eines einzelnen Projekts eindeutig sein. Es gibt jedoch keine Einschränkungen für die Verwendung desselben Teamnamens in verschiedenen Projekten innerhalb einer Projektsammlung. Weitere Informationen finden Sie unter Hinzufügen eines anderen Teams oder einer Hierarchie von Teams.

Teamnamen müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Length Darf nicht mehr als 64 Unicode-Zeichen enthalten.
Eindeutigkeit Darf nicht mit einem anderen Namen im Projekt identisch sein.
Reservierte Namen Darf kein reservierter Systemname 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 ..

Benutzernamen

Benutzerkonten identifizieren Personen, die zu einem Projekt oder einer Projektsammlung hinzugefügt wurden. Benutzerkonten können Einträgen in Active Directory, Microsoft Entra ID, Windows Server-Gruppe entsprechen.

Benutzerkonten, die Sie einer Organisation oder Sammlung hinzufügen, müssen den folgenden Einschränkungen entsprechen. Informationen zum Hinzufügen von Benutzerkonten zu einem Projekt finden Sie unter Hinzufügen von Benutzern zu einem Projekt oder Team.

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

Wiki-Seite und Dateinamen

Jede Wiki-Seite entspricht einer Datei innerhalb des Wiki-Git-Repositorys. Namen, die Sie einem Wiki-Seitentitel zuweisen, müssen den folgenden Einschränkungen entsprechen.

Einschränkungstyp Einschränkung
Dateiname Der vollqualifizierte Seitenpfad sollte 235 Zeichen nicht überschreiten.
Eindeutigkeit Bei Seitentiteln wird die Groß-/Kleinschreibung beachtet, und sie müssen innerhalb der Wiki-Hierarchie eindeutig sein.
Sonderzeichen - Darf keine Unicode-Steuerelementzeichen oder Ersatzzeichen enthalten.
– Darf die folgenden druckbaren Zeichen nicht enthalten: / \ #.
: Darf nicht mit einem Punkt beginnen oder enden ..
Dateigröße Sie dürfen die Maximalgröße von 18 MB nicht überschreiten.
Dateigröße von Anlagen Darf den Höchstwert von 19 MB nicht überschreiten.

Sonderzeichen in Wiki-Seitentiteln

Sie können Seitentitel angeben, die eines oder mehrere dieser Sonderzeichen : < > * ? | -enthalten. Beispielsweise können Sie eine Markdowndatei als "FAQ?" oder "Einrichtungsleitfaden" benennen. Die Zeichen weisen die folgenden URI-codierten Zeichenfolgen auf:

Zeichen Codierte Zeichenfolge
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22