次の方法で共有


名前付けの制限と規則

Azure DevOps Services |Azure DevOps Server 2022 および Azure DevOps Server 2019

Azure DevOps のほとんどのコンポーネントには、名前付けの制限と規則が適用されます。 制限は、一貫性のあるユーザー エクスペリエンスを保証し、他のアプリケーションとの互換性を確保するのに役立ちます。

一般的な制限には、名前の文字長を超えない、特殊文字を含まない、オブジェクト セット内の名前の一意性の維持などがあります。

重要

ユーザー インターフェイス (UI) ではなく API を使用する場合、API では、UI で制限される文字を含む名前を直接指定できます。

ベスト プラクティス

  • UI の制限に従って一貫性を維持し、予期しない問題を防止します。
  • 名前はプログラムで検証し、特殊文字を適切に処理します。

一般的な考慮事項

この記事の長さの制限は、許可される Unicode 文字数で測定されます。 サロゲート文字は 2 つの Unicode 文字で構成されており、文字数制限には 2 文字としてカウントされます。 詳細については、「 Unicode および文字セットについて」を参照してください。

他のオペレーティング システム ファイルと同様に、ASCII 制御文字 (ASCII 1 から 31) とサロゲートの組み合わせも使用できません。 ファイル名に適用されるオペレーティング システムの制限に関する一般的な情報については、「ファイル、パス、名前空間の名前付け」を参照してください。

システム予約済み名

次のようなシステム予約済み名の使用は避けてください。

  • 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 または WEB

予約済み名の詳細については、「ファイル名、パス、および名前空間」を参照してください。

Azure Artifacts

  • ユニバーサル パッケージは、次の制限に準拠している必要があります。
制限の種類 制限
パッケージ名 - 小文字で指定する必要があります。
- 先頭と末尾には、文字または数字を使用します。
- 文字、数字、連続しないダッシュ、アンダースコア、またはピリオドのみを使用する必要があります。
パッケージ バージョン - ビルド メタデータを使用せずに小文字にする必要があります。
  • フィードは、次の制限に準拠している必要があります。
制限の種類 制限
フィード名 - フィード名では大文字と小文字は区別されません。ただし、既存のフィードと大文字と小文字のみが異なる名前の新しいフィードを作成することはできません。
- 文字または数字で始まり、終わる必要があります。
- '.' または '_' で始めたり、'.' で終わったりすることはできません。
- 次の文字を含めることはできません: @ ~ ;{ } ' + = , <> | / \ ? : & $ * " # [ ] % は使用できません。

Azure Boards

作業項目を使用すると、ソフトウェア開発プロジェクトの計画や追跡に必要な情報を記録できます。 作業項目を使用して、作業内容を記述したり、作業を割り当てたり、進捗状況を追跡したり、チーム内の調整を行ったりできます。 ユーザー ストーリー、タスク、バグ、課題など、さまざまな種類の作業項目が、異なる種類の情報を追跡します。 詳細については、「Azure Pipelines のドキュメント」を参照してください。

すべての作業項目追跡オブジェクトには、1 つ以上の名前が関連付けられています。 ほとんどは表示名 (フレンドリ名) を持ちますが、作業項目の種類とグローバル リストは参照名が関連付けられています。 分かりやすい名前は、フィールドに対してユーザーに表示される固有の識別子です。 フレンドリ名を使用することで、プロジェクト コレクション内のプロジェクトや作業項目の種類全体で一貫性が保たれます。 参照名はシステム内部で使用され、一度定義すると変更できません。

参照名、フレンドリ名、フィールド名、添付ファイル サイズなど、作業項目に関連付けられている複数の要素には制限があります。

領域パスとイテレーション パス

エリア パスイテレーション パスの 2 つの作業項目フィールドは、作業をグループ化するためのツリー構造の階層を提供します。 エリア パスは、製品、機能、または機能領域ごとに作業項目をグループ化します。 イテレーション パスは、作業項目をスプリント、マイルストーン、または期間ごとにグループ化して、それらの作業項目別の作業を支援します。

これらのマルチノード フィールドでは、バックスラッシュ \ を使用して、ツリー構造内のノードの階層を示します。

これらのフィールドの子ノードに割り当てる名前には、以下の制限が適用されます。

制限の種類 制限
ノード名の長さ 255 文字以内で指定します。
予約済みの名前 - 1 つのピリオド .、または 2 つのピリオド .. のみを名前として指定することはできません。
- PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON、AUX などのシステム予約済み名を使用することはできません。 予約済み名の詳細については、「ファイル名、パス、および名前空間」を参照してください。
ノードで使用できない特殊文字 - Unicode 制御文字は使用できません。
- 次の文字は使用できません: \ / : * ? " < > | # $ & * +
- ローカル ファイル システムで禁止されている文字は使用できません。 Windows の文字制限の詳細については、「 ファイル、パス、および名前空間の名前付け」を参照してください。
パス名の長さ 4,000 Unicode 文字を超えてはなりません。
パスの階層の深さ 深さは 14 レベル未満で指定します。

添付ファイル

作業項目に添付されるファイルには、以下の制限が適用されます。

制限の種類 制限
ファイル サイズ 最大サイズを超えてはなりません
- 既定の最大サイズ: 4,096 KB。
- 絶対最大サイズ: 2 GB
制限の種類 制限
ファイル サイズ 最大サイズを超えてはなりません
- 既定の最大サイズ: 4,096 KB。
- 絶対最大サイズ: 2 GB 詳細については、作業項目の添付ファイルの最大サイズの変更に関する記事を参照してください。

ボードの列とスイムレーン名

ボードを使用すると、バックログが対話型の看板になり、作業の視覚的な流れが生まれます。 作業が構想から完了まで進むにつれて、ボード上の項目を更新します。 各列は作業段階を示し、各カードはその作業段階のユーザーのストーリー (青いカード) またはバグ (赤いカード) を表します。

スイムレーンを追加、削除、または名前変更して、ボードをカスタマイズします。 列は、ボード全体の作業フローをサポートします。 スイムレーンを使用すると、異なるクラスの作業をボード上の水平レーンとして管理できます。

列名とスイムレーン名には、以下の制限が適用されます。

制限の種類 制限
Length 256 Unicode 文字を超えてはなりません。
一意性 - 列名は、ボード上の他の列名と重複してはなりません。
- スイムレーン名は、ボード上の他のスイムレーン名と重複してはなりません。
特殊文字 - Unicode 制御文字またはサロゲート文字は使用できません。

フィールド名

各作業項目の種類には、1 つ以上の作業項目フィールドが含まれます。 これらのフィールドは、作業項目の種類に基づいて作業項目に格納される情報を定義します。 各作業項目フィールドには、対応するフィールド参照名が設定されています。 フィールド参照名は各フィールドを一意に識別し、一度割り当てられると変更できません。 すぐに使用できる作業項目フィールドの詳細については、「作業項目フィールド インデックス」を参照してください。

作業項目フィールド名には、以下の制限が適用されます。

制限の種類 制限
Length 128 Unicode 文字を超えてはなりません。
一意性 - フィールド名には、少なくとも 1 つの英字が含まれている必要があります。
- 次の文字は使用できません: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |
- 先頭または末尾にスペースは使用できません。
- 2 つ以上の連続するスペースは使用できません。
特殊文字 組織またはプロジェクト コレクション内で一意でなければなりません。 作業項目フィールド名は、プロジェクト コレクションのスコープ内で管理されます。 フィールド名を変更すると、そのコレクション内で定義されているすべての作業項目および作業項目の種類に対して変更が反映されます。

フィールド参照名と移植性

作業項目の種類定義言語には、フィールド参照名の概念が含まれています。 フィールド参照名を使用すると、Team Foundation プロジェクト コレクション間で定義を移植できるほか、Microsoft 以外の統合ソリューションでも特定のフィールドを識別および参照できるようになります。 これらの名前は、.NET Framework アプリケーションの名前空間と同様に、グローバルに一意です。

System 名前空間は、Team Foundation システム関数に必須のすべてのコア システム フィールドを定義するためにのみ使用されます。 独自の System.X フィールドは機能を妨げる可能性があるため、作成できません。

Microsoft 名前空間は、作業項目追跡用のフィールドを定義するために使用されます。 これらのフィールドは、プロセス テンプレートの作業項目の種類定義内で定義されています。

お客様やパートナーは、カスタムの作業項目の種類に対応する独自のフィールド名前空間を作成できます。 システム フィールドおよび既定のプロセス テンプレートで定義されているフィールドの説明については、「作業項目フィールドのインデックス」を参照してください。

重要

  • フィールド参照名は変更できません。 たとえば、フィールド名 "Title" を "Header" に変更しても、そのフィールドの参照名は変更されません。 統合処理や内部的なフィールド表現では、フィールド名そのものではなく、フィールド参照名を使用する必要があります。
  • Microsoft.X フィールドを独自に作成することもできますが、機能に支障が出たり、機能構成ウィザードによるアップグレード後のプロジェクト更新が正常に行えなくなる可能性があるため、お勧めしません。

フィールド参照名の例

以下に、さまざまな名前空間の有効なフィールド参照名の例を示します。 お客様やパートナーも、独自の名前空間を定義してカスタムの作業項目の種類に対応できます。

System 名前空間の例 Microsoft 名前空間の例 その他の名前空間の例
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 たとえば Fabrikam Fiber という架空の会社であれば、次のようなカスタム作業項目フィールドを定義することが考えられます。
FabrikamFiber.Common.Severity、FabrikamFiber.Common.Phase、FabrikamFiber.RiskManagement.RiskType、FabrikamFiber.RiskManagement.Resolution

架空のソフトウェア会社 Contoso Corporation が、次の作業項目フィールドを定義することが考えられます。
Contoso.Common.BusinessPriority、Contoso.Bug.FoundInPhase、Contoso.Bug.FixInPhase

フィールドのヘルプ テキスト

実行時にヘルプ テキストを表示すると、ユーザーがフィールドに入力する内容を把握しやすくなります。 ヘルプ テキストは、特定のプロジェクト内の特定の作業項目の種類に対してスコープが設定されます。

継承プロセスlで、フィールドのヘルプ テキストを指定するには、[編集フィールド] ダイアログボックスの [既定] タブにある [説明] を使用します。 「作業項目の種類にユーザー設定フィールドを追加する」を参照してください。 オンプレミスの XML プロセスでは、HELPTEXT 要素を使用してヘルプ テキストを指定します。 「作業追跡用のフィールドを追加または変更する」を参照してください。

追加するヘルプ テキストには、以下の制限が適用されます。

制限の種類 制限
Length 255 Unicode 文字を超えてはなりません。

グローバル リスト

グローバル リストは、オンプレミス Azure DevOps Server インスタンス内のすべてのプロジェクト コレクションで使用できるリスト項目値のセットです。 作業項目の種類を定義していくと、いくつかのフィールドが同じ許容値や推奨値を共有する場合があります。 グローバル リストを使用すれば、これらの値を一度定義し、複数の作業項目の種類やプロジェクトで共有できます。 詳細については、「グローバル リストの定義」を参照してください。

GLOBALLIST要素を使用して定義されたグローバル リストには、LISTITEM要素を使用して指定された 1 つ以上のリスト項目が含まれます。

LISTITEM 名には、以下の制限が適用されます。

制限の種類 制限
Length - 254 Unicode 文字を超えてはなりません。
- 空にしないでください。
特殊文字 - 先頭または末尾にスペースは使用できません。
- 2 つの連続するスペースは使用できません。
- バックスラッシュ \ は使用できません。
Scope グローバル リストはすべてのプロジェクトで共有されるため、プロジェクト レベルで定義された要素 (プロジェクト固有のグループ アカウント定義など) を含めることはできません。

グローバル リストには以下の制限が適用されます。

制限の種類 制限
項目数 - 空にすることはできません。 グローバル リストには、少なくとも 1 つの LISTITEM 要素が含まれている必要があります。
一意性 - 空にすることはできません。 グローバル リストには、少なくとも 1 つの LISTITEM 要素が含まれている必要があります。

リンクの種類やカテゴリを追加または作成する際には、参照名を定義します。 すべての参照名は最大 70 Unicode 文字まで使用できます。

参照名は、英数字、アンダースコア、ハイフンを使用して定義します。 各参照名には 1 つ以上のピリオド . を含める必要がありますが、名前の先頭または末尾にピリオドを表示することはできません。 参照名は、先頭に数字またはアンダースコアを使用することはできません。また、--など、複数の連続するハイフンを使用することはできません。

制限の種類 制限
Length 70 Unicode 文字を超えてはなりません。
一意性 - プロジェクト コレクション内の他のフィールド参照名と重複してはなりません。
- すべてのピリオド . がアンダースコア _ に置き換えられた後の名前が、他のフィールド参照名と重複してはなりません。 たとえば、フィールド参照名 My.*Field*My.Field は、どちらも処理後には同じ名前 My__Field になります。
特殊文字 - ハイフン - は使用できません。
- 1 つ以上のピリオド.を使用する必要があります。
- 先頭または末尾にピリオド . を使用することはできません。
- 先頭に数字またはアンダースコア _ を使用することはできません。

作業項目のタグ

作業項目タグは、バックログ、ボード、クエリなどの作業追跡ツールでのフィルターや、クエリ定義に使用される 1 語または 2 語のキーワード フレーズです。 詳細については、「Azure Boards でサンプルの作業項目テンプレートを表示する」を参照してください。

タグ名には、以下の制限が適用されます。

制限の種類 制限
Length - 400 Unicode 文字を超えてはなりません。
- null または空は使用できません。
特殊文字 - 区切り文字 ,; は使用できません。
- Unicode コントロールまたは書式文字 (改行、段落区切り、キャリッジ リターン、その他の不一致のサロゲート文字など) を含めることはできません。
Scope グローバル リストはすべてのプロジェクトで共有されるため、プロジェクト レベルで定義された要素 (プロジェクト固有のグループ アカウント定義など) を含めることはできません。

Azure Pipelines

Azure Pipeline の定義には以下の制限が適用されます。

制限の種類 制限
ジョブ名 英数字および '_' のみ使用可能です。
- 先頭を数字にすることはできません。
- 一意の名前でなければなりません。
- "deployment" などのキーワードは使用できません。
ステージ名 英数字および '_' のみ使用可能です。
- 先頭を数字にすることはできません。
- "deployment" などのキーワードは使用できません。
先頭には a-Z または _AND を使用し、続いて a-Z0-9、または _ を使用します。

詳細については、「Azure Pipelines のドキュメント」を参照してください。

Azure Repos (Git)

各 Azure DevOps プロジェクトには複数の Git リポジトリを含めることができます。 Git リポジトリに割り当てる名前には、以下の制限が適用されます。 詳細については、「Azure Repos Git のドキュメント」を参照してください。 ブランチやタグなど他の Git 項目の名前制限については、「git check-ref-format」を参照してください。

重要

リポジトリ名にはスペースを含めることができますが、お勧めしません。

制限の種類 制限
Length 64 Unicode 文字を超えてはなりません。
一意性 プロジェクト内で他の Git リポジトリ名と重複してはなりません。
特殊文字 - Unicode 制御文字またはサロゲート文字は使用できません。
- 次の表示可能文字は使用できません: \ / : * ? " < > ; # $ * { } , + = [ ] |
- 先頭にアンダースコア _ を使用してはなりません。
- 先頭または末尾にピリオド . を使用することはできません。
- システム予約済み名を使用することはできません。

Azure Repos (TFVC)

Team Foundation バージョン管理 (TFVC) は、チーム全体でファイルを管理するための中央リポジトリとコマンドを提供します。 また、カスタマイズ可能なチェックイン ポリシー、分岐、マージ、棚付け、およびその他の多くの機能も提供します。 詳細については、「Azure AD TFVC のドキュメント」を参照してください。

バージョン管理パスには、以下の制限が適用されます。 「ワークスペースの最適化」も参照してください。

制限の種類 制限
サーバー側ソース管理フォルダーのパスの長さ - 1 つのフォルダーまたはファイル名は、259 Unicode 文字を超えてはなりません。
- ディレクトリに 388 文字を超える Unicode 文字は使用できません。
- ディレクトリとファイル名を合わせた長さは 399 Unicode 文字を超えてはなりません。
ローカル フォルダーのパスの長さ - ディレクトリは 248 Unicode 文字を超えてはなりません。
- ディレクトリとファイル名を合わせた長さは 260 Unicode 文字を超えてはなりません。
Web ポータルと REST 固有の長さの制限 プロジェクト名、ディレクトリ、ファイル名の合計が、215 Unicode 文字を超えてはなりません。

Web ポータルと REST API では、特定の操作のパスの長さは、Visual Studio や TF.exe クライアントよりも制限が厳しくなっています。 これらの操作には、編集、名前の変更、削除が含まれます。Web ポータル/REST では、変更を保留すると、ランダムに生成されたワークスペースがコンカレンシーに使用されるために発生します。

TFVC ファイル

バージョン 管理システムには、さまざまな種類のファイルが格納されます。 既存の Visual Studio プロジェクトやソリューションの追加方法については、「開発用コンピューターで Team Foundation バージョン コントロールを設定」を参照してください。

Team Foundation バージョン管理に追加するファイルおよびフォルダーには以下の制限が適用されます。

制限の種類 制限
ファイルとフォルダー - 次の表示可能文字を名前に含めてはなりません: \ / : * ? " < > ;
- フォルダーは、アクティブ ワークスペースでマップされたディレクトリの外に配置できません。
ファイル名 - 先頭に $ は使用できません。
- 次の表示可能文字は使用できません: \ / : * ? " < > ; |

TFVC ラベル

Team Foundation バージョン 管理 (TFVC) では、ラベルは特定のリビジョン セットに適用される名前です。 ラベルをバージョン管理内の無関係なファイルのセットに付与して、それらのファイルをまとめて取得または操作できます。 以下の表に、ラベル名に適用される制限を示します。

制限の種類 制限
Length 64 Unicode 文字を超えてはなりません。
特殊文字 - 末尾をスペース ( ) またはピリオド . にすることはできません。
- 次の表示可能文字は使用できません: \ / : * ? " < > ; @ |

TFVC シェルブセット

シェルブセットを使用すると、保留中の変更の一括を一時的に退避させ、必要に応じてワークスペースから変更を削除できます。 後で、そのシェルブセットから変更を復元して自分のワークスペースに戻すか、他のユーザーのワークスペースに適用できます。

シェルブセット名には、以下の制限が適用されます。

制限の種類 制限
Length 64 Unicode 文字を超えてはなりません。
特殊文字 - 次の表示可能文字は使用できません: \ / : * ? " < > & ; |。

TFVC ワークスペース

ワークスペースとは、Team Foundation バージョン管理 (TFVC) のファイルとフォルダーのクライアント側コピーのことです。 複数のワークスペースを作成することで、同じバージョン管理フォルダーの異なるバージョンをクライアント コンピューター上に保持できます。 詳細については、「ワークスペースの作成と操作」を参照してください。

ワークスペース名には、以下の制限が適用されます。

制限の種類 制限
Length 64 Unicode 文字を超えてはなりません。
特殊文字 - 末尾にスペース ( ) は使用できません。
- 次の表示可能文字は使用できません: \ / : * ? " < > ;

コンピューター名

Azure DevOps をインストールしたコンピューター名は、サーバー名と関連付けられます。 オペレーティング システムと Active Directory の両方で、コンピューター名に特定の制限が適用されます。次の記事を参照してください。

組織名

重要

組織名を作成するときは、次のガイドラインに従います。

  • 英語のアルファベットの文字のみを使用します
  • 組織名の先頭には、文字または数字を使用します。
  • 最初の文字の後には、文字、数字、またはハイフンを使用します
  • 組織名は 50 Unicode 文字以内とします
  • 末尾には文字または数字を使用します。

許可されていない文字のいずれかを使用すると、次のエラー メッセージが表示されます: VS850015: 指定した名前は使用できません: {組織名}。

プロセス テンプレートとプロセス テンプレート

プロセスは、プロジェクトに接続した後にアクセスできる作業項目追跡システムおよびその他のサブシステムの構成要素を定義します。

用語: "プロセス" と "プロセス テンプレート" の両方は、プロジェクトの作成に使用される相互依存のファイルのセットを指します。 詳細については、「 プロセスとプロセス テンプレートに関するページを参照してください。このテンプレートでは、使用可能な 3 つの既定のプロセスの違いについて説明します。

定義またはカスタマイズするプロセスには、以下の制限が適用されます。

制限の種類 制限
Length 256 Unicode 文字を超えてはなりません。
一意性 - Azure DevOps 全体で一意である必要があります。
- 既存のテンプレートと同じ名前のテンプレートをアップロードすると、既存のテンプレートが上書きされます。
プロセス テンプレート ファイルのサイズ 2 GB (ギガバイト) を超えてはなりません。

プロジェクト コレクション

プロジェクト コレクションは、プロジェクトのグループと、それらのプロジェクトに関連付けられているリソースを識別します。 これは、Azure DevOps Server 用に定義されたプロジェクトのグループを定義および制御するために使用できる整理構造を提供します。

また、コレクション名は、チーム メンバーをプロジェクトに接続するために使用される接続文字列の一部です。 既定の割り当ては、DefaultCollection に対応します。 詳細については、「プロジェクト コレクションの管理」 詳細を提供します。

プロジェクト コレクションに割り当てる名前には、以下の制限が適用されます。

制限の種類 制限
Length 64 Unicode 文字を超えてはなりません。
一意性 - オンプレミスのデプロイ内の他のコレクション名と重複してはなりません。
デプロイに SharePoint Products や SQL Server Reporting Services が含まれている場合、既存の SharePoint サイト、レポート サーバー、または Reporting Services Web サイトの名前および完全パスと重複してはなりません。
予約済みの名前 システム予約済み名を使用することはできません。
特殊文字 - Unicode 制御文字またはサロゲート文字は使用できません。
- 次の表示可能文字は使用できません: \ / : * ? " < > ; # $ * { } , + = [ ] |
- 省略記号 ... または二重ピリオド .. は使用できません。
- 先頭にアンダースコア _ を使用してはなりません。
- 先頭または末尾にピリオド . を使用することはできません。

プロジェクト名

プロジェクトでは、ソース コード用のリポジトリと、チームが進捗状況を計画、追跡、共同作業するための場所を確立します。 プロジェクトの名前は、チーム メンバーをプロジェクトに接続するために使用される接続文字列の一部です。

作成するプロジェクトに割り当てる名前には、以下の制限が適用されます。

制限の種類 制限
Length 64 Unicode 文字を超えてはなりません。
一意性 プロジェクト コレクション内の他の名前、コレクションをサポートする SharePoint Web アプリケーション、またはコレクションをサポートする SQL Server Reporting Services のインスタンスと重複してはなりません。
名前を予約する - システム予約済み名を使用することはできません。
- App_Browsers、App_code、App_Data、App_GlobalResources、App_LocalResources、App_Themes、App_WebResources、bin、web.config などの IIS 要求のフィルター処理に使用される非表示セグメントの 1 つを指定する必要があります。
特殊文字 - Unicode 制御文字またはサロゲート文字は使用できません。
- 次の表示可能文字は使用できません: \ / : * ? " ' < > ; # $ * { } , + = [ ] |
- 先頭にアンダースコア _ を使用してはなりません。
- 先頭または末尾にピリオド . を使用することはできません。

セキュリティ グループ

Azure DevOps セキュリティ グループを使用すると、特定の権限またはアクセス許可をユーザーのグループに適用できます。

オンプレミス グループは、Active Directory グループ アカウント、Azure DevOps セキュリティ グループ、Windows ユーザー アカウント、Windows グループ アカウント、またはこれらの種類の組み合わせで構成される場合があります。 詳細については、「 Active Directory/Microsoft Entra ユーザーまたはグループを組み込みのセキュリティ グループに追加する」を参照してください。

セキュリティ グループには、以下の制限が適用されます。

制限の種類 制限
セキュリティ グループ アカウント名の長さ 256 Unicode 文字を超えてはなりません。
一意性 - プロジェクト レベルのグループ アカウントは、同じプロジェクト内の他のグループ名と重複してはなりません。
- コレクション レベルのグループ アカウントは、プロジェクト コレクション内のグループ アカウントの他の名前と一致してはなりません。
予約済みグループ名 プロジェクト レベルまたはサーバー レベルで $NAMESPACE を使用して名前を付けてはなりません。
特殊文字 - Unicode 制御文字またはサロゲート文字は使用できません。
- 次の表示可能文字は使用できません: / \ [ ] : < > + = ; ? * |
- ASCII 値の 1 から 31 の範囲に印刷できない文字は使用できません。
- ピリオド . で終わることはできません。
- コンマ , は使用できません。

Team Foundation ビルド

Team Foundation Build を使用すると、ビルド プロセスのすべての側面を 1 台のコンピューターで管理できます。 Team Foundation Build を使用すると、ソースの同期、アプリケーションのコンパイル、関連する単体テストの実行、コード分析の実行、ファイル サーバーでのビルドのリリース、ビルド レポートの発行を行うことができます。

コンピューターのビルド

Team Foundation Build は、Azure DevOps Server アプリケーション層、データ層、または Visual Studio クライアントとは別のインストールです。 別のコンピューターを選択できます。 それ以外の場合は、クライアント コンピューターまたはサーバーにビルドをサイド バイ サイドでインストールできます。

オンプレミスのビルド コンピューターには、以下の制限が適用されます。

制限の種類 制限
ディスク領域 ビルドに十分な領域を含める必要があります (空き領域が不足すると、ビルドが失敗します)。
ビルド ディレクトリ ローカル パス (たとえば、C:\BuildDirectory) を指定する必要があります。
ドロップ場所ディレクトリ UNC パスを指定する必要があります (例: \server\share)。
場所のアクセス許可を削除する 生成された各ビルドは、ドロップ フォルダー内の新しいディレクトリに配置されます。
- Team Foundation Server Service アカウント (例: Domain\TFSSERVICE) には、UNC ドロップ場所へのフル コントロールのアクセス許可が必要です。
- UNC ドロップ場所は共有フォルダーである必要があります。
Team Foundation Build Service アカウント 初回インストール後にに TFS Service アカウントを変更する場合は、次の条件が満たされていることを確認する必要があります。
- アカウントが Build Services グループのメンバーであること。
- アカウントに一時フォルダーおよび ASP.NET の一時フォルダーへの読み取り/書き込みアクセス許可があること。
- アカウントにビルド ディレクトリおよびドロップ場所へのフル コントロールのアクセス許可があること。
ファイアウォールの問題 ビルド コンピューターでファイアウォールが有効になっている場合は、プログラム tfsbuildservice, が例外リストに含まれていることを確認します。

Build 型

ビルドの種類は、プロジェクト内の単一または複数のソリューションをビルドする条件を構成します。 ビルドを実行するには、新しいビルドの種類を作成するか、既存のビルドの種類 を使用する必要があります。

ビルドの種類の名前には、以下の制限が適用されます。

制限の種類 制限
一意性 プロジェクト内の他のビルドの種類の名前と重複してはなりません。
特殊文字 - 次の表示可能文字は使用できません: $

Build 品質

ビルド品質を使用すると、完了したビルドに品質レベルまたは完了状態を関連付けることができます。 Team Foundation Build では、ビルド品質の種類に対して新しい値を作成することもできます。 既定のビルド品質値の一覧については、「完成したビルドの品質を評価する」を参照してください。

Build 品質名には、以下の制限が適用されます。

制限の種類 制限
Length 256 Unicode 文字を超えてはなりません。
一意性 Team Foundation Build コンピューター内の他のビルド品質名と重複してはなりません。

チーム名

チーム名は、プロジェクトでチームとして共同作業を行う個人またはグループ全体を識別します。 チーム メンバーは、この名前を使用してチームに接続したり、チームに対して定義されたメンバーに対してクエリを実行したりします。

チーム名は、有効な URL の一部として表示できる形式に従う必要があります。 各チーム名は、1 つのプロジェクト内で一意である必要があります。 ただし、同じプロジェクト コレクション内の異なるプロジェクトで同じチーム名を使用することに制限はありません。 詳細については、「別のチームまたはチームの階層を追加する」を参照してください。

チーム名には、以下の制限が適用されます。

制限の種類 制限
Length 64 Unicode 文字を超えてはなりません。
一意性 プロジェクト内で他の名前と重複してはなりません。
予約済みの名前 システム予約済み名を使用することはできません。
特殊文字 - Unicode 制御文字またはサロゲート文字は使用できません。
- 次の表示可能文字は使用できません: \ / : * ? " < > ; # $ * { } , + = [ ] |
- 省略記号 ... または二重ピリオド .. は使用できません。
- 先頭にアンダースコア _ を使用してはなりません。
- 先頭または末尾にピリオド . を使用することはできません。

ユーザー アカウント名

ユーザー アカウントは、プロジェクトまたはプロジェクト コレクションに追加されたユーザーを識別します。 ユーザー アカウントは、Active Directory、Microsoft Entra ID、Windows Server グループ内のエントリに対応している場合があります。

組織またはコレクションに追加するユーザー アカウントには、以下の制限が適用されます。 プロジェクトにユーザー アカウントを追加するには、「プロジェクトまたはチームへのユーザーの追加」を参照してください。

制限の種類 制限
アカウント名の長さ 256 Unicode 文字を超えてはなりません。
一意性 プロジェクト コレクションに追加された他のユーザー アカウントと一致してはなりません。
予約済みグループ名 プロジェクト レベルまたはサーバー レベルで、$NAMESPACE を名前として使用してはなりません。
特殊文字 - 次の印刷可能な文字を含めてはなりません: "/ \ [ ] : < > + = ; ? * |.
- ASCII 値の 1 から 31 の範囲に印刷できない文字を含めてはなりません。
-末尾にピリオド . またはドル記号 $ を使用してはなりません。
- コンマ , は使用できません。
- LineSeparator、ParagraphSeparator、Control、Format、OtherNotAssigned の Unicode カテゴリを含めることはできません。

Wiki ページとファイル名

各 Wiki ページは、Wiki Git リポジトリ内のファイルに対応しています。 ページ ファイル名とファイル サイズには、次の制限が適用されます。

  • ファイル名: ページ ファイルの名前を選択するときは、ファイルの完全修飾パスが 235 文字以下である必要があることに注意してください。 ページへの完全なパスは、リポジトリ URL、ページ ファイルへのフォルダー パス、およびページ ファイル名で構成されます。 たとえば、https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md のようにします。

  • 一意性: ページ ファイル名は、Wiki リポジトリ階層内のフォルダーの場所内で一意である必要があります。 名前の大文字と小文字は区別されます。

  • 特殊文字: ページ ファイル名には、次の特殊文字に関する制限があります。

    • Unicode 制御文字またはサロゲート文字なし
    • 表示可能文字は使用できません: スラッシュ /、バックスラッシュ \、ハッシュ記号 #
    • 名前の先頭または末尾にピリオド . 記号がありません
  • ファイル サイズ: ページ ファイルの最大サイズは 18 MB です。

  • 添付ファイルのサイズ: ページ ファイルへの添付ファイルの最大サイズは 19 MB です。

使用できる特殊文字

ページ ファイル名には、コロン : やハイフン -など、いくつかの特殊文字を使用できます。 たとえば、マークダウン ファイルに FAQ:0525 または Setup-Guide という名前を付けることができます。

重要

ページ構文とブラウザー ナビゲーションでエラーが発生しないようにするには、ページ ファイル名にスペース文字 ( ) を使用しないでください。 ページ タイトルに基づいてページ ファイルに名前を付け、ページ タイトル内のスペースをファイル名にハイフン (-) で置き換えます。

次の表に、Wiki ページ ファイル名で使用できる特殊文字と、対応する URI でエンコードされた文字列を示します。

文字 記号 URI 文字列
コロン : %3A
左山かっこ < %3C
終わり山かっこ > %3E
アスタリスク (ワイルドカード) * %2A
疑問符 ? %3F
パイプ | %7C
ハイフン (ダッシュ) - %2D
二重引用符 " %22

たとえば、ファイル名 FAQ:0525FAQ%3A0525としてエンコードされます。