TFSConfig を使用して Azure DevOps をオンプレミスで管理する

accounts コマンドを使用して、これらの Azure DevOps Server サービス アカウントを管理します。

• Azure DevOps Server サービス アカウント
• SQL Server Reporting Services のデータ ソース アカウント
• Azure DevOps プロキシ サーバー サービス アカウント

このコマンドを使用して、Azure DevOps Server データベースの所有権を変更することもできます。

TfsConfig accounts /change|add|set|delete|updatepassword|resetowner
	[/accountType:<adminConsole|applicationTier|proxy|reportingDataSource>]
	[/account:<accountName>] [/password:<password>]
	[/sqlInstance:<serverName>] [/databaseName:<databaseName>] [/continue]

既定値は ApplicationTier です。

sqlInstance と databaseName は、アプリケーション層を構成する前に、データベースにアカウントを追加する場合にのみ適しています。 これは、AT Only 構成ウィザードを実行する前に別のアカウントが必要なディザスター リカバリー シナリオで主に役立ちます。

続行オプションは、アカウントを追加または変更するときに使用されます。 これらの操作の場合、アカウントは各コレクション データベースで変更されます。 continue を指定すると、コレクションに到達できない場合は続行されます。 到達可能な場合は、もう一度実行できます。

前提条件

accounts コマンドを使用するには、次のメンバーである必要があります。

• Azure DevOps Administrators セキュリティ グループ
• Azure DevOps Server インスタンスが使用するすべての SQL Server インスタンスの sysadmin ロール。

/proxy オプションを使用する場合は、プロキシ サーバーの管理者である必要があります。

詳細については、「 Azure DevOps Server のアクセス許可リファレンス」を参照してください。

注釈

accounts コマンドを使用して、Azure DevOps Server のサービス アカウント、データベース、およびサービス アカウント グループへの変更を自動化します。 既に作成したアカウントを構成することはできますが、アカウントを作成することはできません。

アカウントのドメインまたはワークグループを変更する前に、アカウントに機密性の高いアカウントが必要であり、アプリケーション層サーバーでアクセス許可を委任することはできません。 詳細については、Microsoft Web サイトの「 委任された認証の有効化」のページを参照してください。

accounts コマンドは、オンプレミスの Azure DevOps Server デプロイをサポートします。 Azure DevOps Services アカウントのアカウント所有者を変更するには、「アカウントの 所有権を変更する」を参照してください。

例示

データ ソースのサービス アカウントを Contoso ドメイン内の新しいアカウントContoso\NewAccount に変更し、パスワードを Password に変更します。

TfsConfig accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password

ネットワーク サービス システム アカウントを Azure DevOps Server のサービス アカウント グループに追加します (システム アカウントにはパスワードがありません)。

TfsConfig accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

TFS_Warehouse名前付きインスタンス内の ContosoMain SQL Server 上のTeamDatabases データベースの所有権を、コマンドを実行しているユーザー アカウントに変更します。

TfsConfig accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse

addProjectReports コマンドを使用して、既存のチーム プロジェクトのレポートを追加または上書きします。

TfsConfig addProjectReports /collection:<teamProjectCollectionUrl> /teamProject:<projectName> /template:<templateName>
[/force]

前提条件

addProjectReports コマンドを使用するには、TFSConfig を実行してレポート サービスにレポートをアップロードするためのアクセス許可が必要です。

注釈

プロジェクトにレポートがない場合、またはプロセスに対して定義されているレポートを更新する場合は、 addProjectReports コマンドを使用します。

このコマンドは、次の場合に使用する必要がある場合があります。

• プロジェクトは、Visual Studio ではなく Azure DevOps ポータルで作成されました
• プロジェクトは Visual Studio から作成されましたが、レポートは Azure DevOps Server で構成されていませんでした。

Azure DevOps Server をアップグレードし、プロジェクト内の古いレポートの互換性がなくなったため、プロジェクト内のレポートを既定のレポートで上書きする場合は、 /force オプションを使用します。 レポートをカスタマイズした場合は、これを行う前にバックアップを作成してください。

オンプレミスの Azure DevOps Server へのレポートの追加の詳細については、「 プロジェクトへのレポートの追加」を参照してください。

例

次の例では、アジャイル レポートをプロジェクト コレクション内 MyProject プロジェクト http://myTfsServer:8080/tfs/DefaultCollection 追加する方法を示します。

TFSConfig addProjectReports /collection:http://myTfsServer:8080/tfs/DefaultCollection /teamproject:MyProject /template:Agile

Authentication コマンドは、Azure DevOps Server アプリケーション層またはプロキシ Web サイトで使用されるネットワーク認証プロトコルを変更します。

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]

前提条件

認証コマンドを使用するには、siteType オプションの値に応じて、Azure DevOps Administrators セキュリティ グループのメンバーであり、アプリケーション層サーバーまたはプロキシ サーバーのローカル管理者である必要があります。

注釈

Authentication コマンドは、Azure DevOps Server が依存している 1 つ以上の Web サイトのネットワーク認証プロトコルを変更する管理者によって使用されます。 管理者は、アプリケーション層からこのコマンドを実行して、ネットワーク認証プロトコルの変更を必要とする Web サイトを更新します。 このコマンドは、IIS メタベースの NTAuthenticationProviders プロパティを変更します。

認証コマンドを使用して 認証 プロトコルを変更する前に、 /viewAll オプションを指定してコマンドを実行して、既存の設定を確認できます。

例

次の例では、ネットワーク認証プロトコルに割り当てられている現在の値を表示します。

TFSConfig Authentication /viewAll

certificates コマンドを使用して、HTTPS、Secure Sockets Layer (SSL)、証明書を利用する Azure DevOps Server のデプロイでのクライアント認証用の証明書の構成方法を変更します。

TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]

前提条件

certificates コマンドを使用するには、コマンドを実行するコンピューターの Azure DevOps Administrators セキュリティ グループとローカル Administrators グループのメンバーである必要があります。 詳細については、「 Azure DevOps Server のアクセス許可リファレンス」を参照してください。

注釈

既定では、 certificates コマンドは、現在のユーザーの証明書一覧からクライアント証明書を自動的に選択します。 ただし、コマンドのオプションを使用して、現在のユーザー コンテキストまたはローカル コンピューター コンテキストから特定の証明書を指定できます。

certificates コマンドを使用する前に、まず、Azure DevOps Server のデプロイで証明書を利用するようにサーバーを構成する必要があります。 詳細については、「 Azure DevOps Server 用の Secure Sockets Layer (SSL) を使用した HTTPS の設定」を参照してください。

certificates コマンドを使用して、HTTPS/SSL と証明書を使用するように構成された Azure DevOps Server のデプロイで使用されるクライアント証明書を構成します。 オプションなしで Certificates コマンドを使用すると、コマンドを実行する現在のユーザー コンテキストからクライアント証明書が自動的に選択されます。

例示

次の例は、プロンプトなしで拇印 aa bb cc dd ee を持つローカル コンピューター証明書を指定する方法を示しています。

TfsConfig certificates /machine /thumbprint:aa bb cc dd ee /noprompt

次の例は、現在のユーザー ストアからのクライアント証明書の自動選択を使用して指定する方法を示しています。

TfsConfig certificates /autoselect

changeServerID コマンドは、Azure DevOps Server のデータベースに関連付けられている GUID を変更します。 GUID は、Azure DevOps Server のデプロイ内で一意である必要があります。 複数のデータベースに同じ GUID がある場合、デプロイが不安定になったり、使用できなくなったりする可能性があります。 構成データベースの GUID、配置内のすべてのプロジェクト コレクション データベースの GUID、またはその両方を変更できます。

通常、このコマンドは毎日の操作では使用しませんが、次の状況ではこのコマンドを使用できます。

• デプロイを新しいハードウェアに復元し、古いデプロイは引き続き動作しており、両方のデプロイを利用する必要があります。 このシナリオは、サーバーの複製と呼ばれることもあります。

• 運用環境を中断するリスクがないように、重複する展開でソフトウェア更新プログラムまたはハードウェア構成をテストする必要があります。

• デプロイを確実に復元できるように、テスト ラボまたは別の環境の新しいハードウェアへのデータベースの復元を完全にテストする必要があります。

• コレクション データベースの GUID は、その GUID が既に予約されている別のデプロイに移動した後でリセットする必要があります。

TfsConfig changeServerID /sqlInstance:<serverName> /databaseName:<configurationDatabaseName>
	[/projectCollectionsOnly] [/configDBOnly] [/collectionName]

前提条件

changeServerID コマンドを使用するには、Azure DevOps Administrators セキュリティ グループのメンバーであり、Azure DevOps Server が使用するすべての SQL Server インスタンスの sysadmin セキュリティ ロールのメンバーである必要があります。 詳細については、「 Azure DevOps のアクセス許可リファレンス」を参照してください。

注釈

changeServerID コマンドを使用して、テストまたは複製のために Azure DevOps Server のデプロイの個別の複製を作成します。 changeServerID コマンドを使用した後、変更されたサーバーを使用する前に、クライアントに変更されたサーバーへの接続を作成するように指示する必要があります。

例

次の例では、Azure DevOps Server の Contoso1 デプロイ内のすべてのデータベースの GUID を変更する方法を示します。構成データベースは、SQL Server の名前付きインスタンス ContosoMain上のTeamDatabasesサーバーでホストされます。

TfsConfig changeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

codeIndex コマンドを使用して、Azure DevOps Server でのコード インデックス作成を管理します。 たとえば、インデックスをリセットして CodeLens 情報を修正したり、インデックス作成をオフにしてサーバーのパフォーマンスの問題を調査したりできます。

TfsConfig codeIndex /indexingStatus | /setIndexing:[on|off|keepupOnly] |
	/ignoreList:[ add | remove | removeAll | view ] <serverPath> |
	/listLargeFiles [/fileCount:FileCount] [/minSize:MinSize] |
	/reindexAll | 
    /destroyCodeIndex [/noPrompt] |
	/temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] |
	/indexHistoryPeriod:[ view | all | <NumberOfMonths> ] [/collectionName:<collectionName> | /collectionId:<collectionId>]

前提条件

codeIndex コマンドを使用するには、Azure DevOps Administrators セキュリティ グループのメンバーである必要があります。 Azure DevOps Server のアクセス許可リファレンスを参照してください。

例示

コードインデックス作成の状態と構成を表示するには:

TfsConfig codeIndex /indexingStatus /collectionName:"Fabrikam Web Site"

すべての変更セットのインデックス作成を開始するには:

TfsConfig codeIndex /setIndexing:on /collectionName:"Fabrikam Web Site"

以前に作成した変更セットのインデックス作成を停止し、新しい変更セットのインデックス作成のみを開始するには:

TfsConfig codeIndex /setIndexing:keepupOnly /collectionName:"Fabrikam Web Site"

10 KB を超える最大 50 個のファイルを検索するには:

TfsConfig codeIndex /listLargeFiles /fileCount:50 /minSize:10 /collectionName:"Fabrikam Web Site"

特定のファイルをインデックス作成から除外し、無視されたファイル リストに追加するには:

TfsConfig codeIndex /ignoreList:add "$/Fabrikam Web Site/Catalog.cs" /collectionName:"Fabrikam Web Site"

インデックスが作成されていないすべてのファイルを表示するには:

TfsConfig codeIndex /ignoreList:view

以前にインデックスが作成されたデータを消去し、インデックス作成を再開するには:

TfsConfig codeIndex /reindexAll /collectionName:"Fabrikam Web Site"

すべての変更セット履歴を保存するには:

TfsConfig codeIndex /indexHistoryPeriod:all /collectionName:"Fabrikam Web Site"

CodeLens の一時データのサイズ制限を削除し、一時データ サイズに関係なくインデックス作成を続行するには:

TfsConfig codeIndex /temporaryDataSizeLimit:disable /collectionName:"Fabrikam Web Site"

確認を行ってコード インデックスを削除するには:

TfsConfig codeIndex /destroyCodeIndex /collectionName:"Fabrikam Web Site"

コレクション コマンドを使用すると、Azure DevOps Server のデプロイからプロジェクト コレクションをアタッチ、デタッチ、または削除できます。 コレクション コマンドを使用して、既存の コレクション のデータベースを複製し、名前を変更して、配置にアタッチすることもできます。 このプロセスは、コレクションの複製と呼ばれることもあります。

TfsConfig collection {/attach | /create | /detach | /delete} [/collectionName:<collectionName>]
    [/description:<collectionDescription>]
    [/collectionDB:<serverName>;<databaseName>]
    [/processModel:Inheritance|Xml]
    [/reportingFolder:<reportingFolderPath>]
    [/clone] [/verify] [/continue]

前提条件

collections コマンドを使用するには、Team Foundation Administrators セキュリティ グループと、TfsConfig を実行しているコンピューター上のローカル Administrators グループのメンバーである必要があります。 また、Azure DevOps Server データベースで使用される SQL Server のすべてのインスタンスの sysadmin セキュリティ ロールのメンバーである必要があります。 展開が SharePoint と統合されていて 、/delete オプションを使用している場合は、サイト コレクションを削除する SharePoint ファームのファーム管理者グループのメンバーである必要もあります。

詳細については、「 Azure DevOps Server のアクセス許可リファレンス」を参照してください。

注釈

コレクションを対話形式で管理したり、コレクションを作成したりするには、Azure DevOps の管理コンソールで Project Collections ノードを使用できます。 Manage プロジェクト コレクションを参照してください。

例示

次の例は、Azure DevOps Server のデプロイから Contoso Summer Intern Projects プロジェクト コレクションを完全に削除する方法を示しています。

TfsConfig collection /delete /CollectionName:"Contoso Summer Intern Projects"

TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.
Deleting a project collection is an irreversible operation. A deleted collection cannot be reattached to the same or another Team Foundation Server. Are you sure you want to delete 'Contoso Summer Intern Projects'? (Yes/No)
Yes
Found Collection 'Contoso Summer Intern Projects' Deleting...
The delete of collection 'Contoso Summer Intern Projects' succeeded.

次の例は、 Contoso Summer Interns Projects プロジェクト コレクションを複製し、 Contoso Winter Interns Projects名前を付け、重複するコレクションを Azure DevOps Server のデプロイにアタッチする方法を示しています。

TfsConfig collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects"
    /CollectionName:"Contoso Winter Intern Projects" /clone

columnStoreIndex コマンドを使用して、Azure DevOps Server デプロイで使用されるデータベースの列ストア インデックスを有効または無効にします。

TfsConfig columnStoreIndex /enabled:<true|false>
	/sqlInstance:<serverName>
	/databaseName:<databaseName>

前提条件

columnStoreIndex コマンドを使用するには、指定された SQL Server インスタンスの sysadmin ロールのメンバーである必要があります。

注釈

通常、列ストア インデックスをサポートしている SQL インスタンスから、サポートされていない SQL インスタンスにデータベースを移動する場合は、 columnStoreIndex コマンドを使用します。 この場合、データベースを正常に移動するには、すべての列ストア インデックスを無効にする必要があります。 同様に、列ストア インデックスをサポートする SQL インスタンスにデータベースを戻す場合は、領域を節約してパフォーマンスを向上させるために、列ストア インデックスを再度有効にすることをお勧めします。

例

次の例は、名前付きインスタンス TFS_DefaultCollection上の ContosoMain という名前のサーバーで実行されている SQL インスタンスでTeamDatabasesという名前のデータベースに対して、列ストア インデックスを有効にする方法を示しています。

TfsConfig columnStoreIndex /enabled:true /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection

dbCompression コマンドを使用して、Azure DevOps Server デプロイで使用されるデータベースのデータベース ページ圧縮を有効または無効にします。

TfsConfig dbCompression /pageCompression:[enable|disable]
	/sqlInstance:<serverName>
	/databaseName:<databaseName>
	[/rebuildNow [/offline]]

前提条件

dbCompression コマンドを使用するには、指定された SQL Server インスタンスの sysadmin ロールのメンバーである必要があります。

注釈

圧縮をサポートしている SQL インスタンスからそうでない SQL インスタンスにデータベースを移動する場合は、通常、 dbCompression コマンドを使用します。 この場合は、データベースを正常に移動する前に、圧縮を無効にし、すべてのインデックスを展開する必要があります。 同様に、圧縮をサポートする SQL インスタンスにデータベースを戻す場合は、領域を節約するために圧縮を再度有効にすることをお勧めします。

このコマンドは、Azure DevOps Server がデータベース ページの圧縮を使用するかどうかを変更するだけです。データベースは、圧縮をサポートする SQL インスタンスでホストされている必要があります。 詳細については、「 SQL Server の各エディションでサポートされる機能 」を参照してください。

例

次の例では、名前付きインスタンス TFS_DefaultCollectionで ContosoMain という名前のサーバー上で実行されている SQL インスタンス上の TeamDatabases という名前のデータベースに対して、インデックスをオンラインで再構築して、ページ圧縮をすぐに有効にする方法を示します。

TfsConfig dbCompression /pageCompression:enable /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /rebuildNow

deleteTestResults コマンドを使用して、古い保存済みテスト結果をコレクション ストアから削除します。 これは通常、ストア のサイズを小さくしたり、テスト結果を新しいスキーマに移行するときの時間を短縮したりするために行われます。

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]

前提条件

deleteTestResults コマンドを使用するには、指定された SQL Server インスタンスの sysadmin ロールのメンバーである必要があります。

注釈

/preview パラメーターを使用して、これらの結果を削除せずにプロジェクト名と年で並べ替えられたテスト結果を表示します。

例

次の例では、名前付きインスタンス TFS_DefaultCollection上の ContosoMain という名前のサーバーで実行されている SQL インスタンス上の TeamDatabases という名前のデータベースについて、60 日より前の手動テスト結果を削除する方法を示します。

TfsConfig deleteTestResults /ageInDays:60 /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /type:manual

deploymentPool コマンドは、すべてのデプロイ グループを 1 つのデプロイ プールから別のデプロイ プールに移行するように設計されています。

TfsConfig deploymentpool /migrateDeploymentGroups /fromPool:<source pool name> /toPool:<destination pool name>

ID コマンドは 、 Azure DevOps Server のデプロイでユーザーとグループのセキュリティ識別子 (SID) を一覧表示または変更します。 次のいずれかのシナリオで、ユーザーとグループの SID を変更または更新する必要がある場合があります。

• デプロイのドメインを変更する

• ワークグループからドメインへの変更、またはドメインからワークグループへの変更

• Active Directory のドメイン間でのアカウントの移行

TfsConfig identities [/change /fromdomain:<domainName1> /todomain:<domainName2>
    [/account:<accountName> [/toaccount:<accountName>]] [/sqlInstance:<serverName> /databaseName:<databaseName>]

前提条件

ID コマンドを使用するには、Team Foundation Administrators セキュリティ グループのメンバーであり、Team Foundation Server が使用するすべての SQL Server インスタンスの sysadmin ロールのメンバーである必要があります。 詳細については、「 Azure DevOps Server の管理者アクセス許可を設定する」を参照してください。

注釈

必要に応じて、デプロイ用にアプリケーション層サーバーを構成する前に、ID を変更するデータベースを指定できます。 たとえば、Azure DevOps Server のデプロイを複製するときに、サービス アカウントを変更するデータベースを指定できます。

ID を変更するときは、ターゲット アカウントが Windows に既に存在している必要があります。

このコマンドで変更したアカウントのプロパティが更新される前に、Windows との次の ID 同期を待つ必要があります。 この要件には、グループからユーザー、ユーザーからグループへの変更、およびドメイン アカウントからローカル アカウントへの変更が含まれます。

例示

次の例では、Azure DevOps Server に格納されているすべての Windows ユーザーとグループの名前を一覧表示し、各ユーザーまたはグループの SID が Windows の SID と一致するかどうかを表示する方法を示します。 Contoso1 ドメイン管理者は、Azure DevOps Server、SQL Server Reporting Services、および SharePoint 製品全体のアクセス許可の管理を容易にするために、 Contoso1\\Developers や Contoso1\\Testers などのドメイン グループを作成しました。

TfsConfig identities

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.

    Account Name Exists (see note 1) Matches (see note 2)
    --------------------------------------------------------------------
    CREATOR OWNER True True
    Contoso1\hholt True True
    BUILTIN\Administrators True True
    Contoso1\Developers True True
    Contoso1\Testers True True
    Contoso1\PMs True True
    Contoso1\jpeoples True True
    Contoso1\Domain Admins True True
    Contoso1\SVCACCT1 True True

    9 security identifiers (SIDs) were found stored in Team Foundation Server. Of these, 9 were found in Windows. 0 had differing SIDs.

次の例は、Azure DevOps Server のすべてのアカウントの SID を Contoso1 ドメインから、 ContosoPrime ドメイン内の一致する名前を持つアカウントの SID に変更する方法を示しています。 一致するアカウント名のみが SID を更新します。 たとえば、 hholt アカウントが Contoso1\hholt および ContosoPrime\hholtとして存在する場合、アカウント SID は ContosoPrime\hholtの SID に変更されます。 ContosoPrime\hholt アカウントが存在しない場合、の SID は更新されません。

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

次の例では、1 つのユーザー アカウント ( Contoso1\hholt) のアカウントを別のユーザー アカウント ( ContosoPrime\jpeoples) のアカウントに変更する方法を示します。

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

次の例は、デプロイのドメインを NT AUTHORITY\NETWORK SERVICE から Contoso1 に変更するときに、Azure DevOps Server のデプロイで使用されるContosoPrime サービス アカウントの SID を変更する方法を示しています。 ネットワーク サービスなどのシステム アカウントを変更するには、2 段階のプロセスに従う必要があります。 最初に、新しいドメイン NT AUTHORITY\NETWORK SERVICEでサービス アカウントを TempSVC からドメイン アカウントに変更してから、新しいドメインのサーバー上の NETWORK SERVICE にアカウントを変更します。 構成データベースは、SQL Server の名前付きインスタンス ContosoMain上のTeamDatabasesという名前のサーバーでホストされます。

TfsConfig identities /change /fromdomain:"NT AUTHORITY" /todomain:ContosoPrime /account:"NETWORK SERVICE"
  /toaccount:TempSVC /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

TfsConfig identities /change /fromdomain:ContosoPrime /todomain:"NT AUTHORITY" /account:TempSVC
	/toaccount:"NETWORK SERVICE"

jobs コマンドを使用すると、特定のプロジェクト コレクションの最新のジョブ アクティビティの詳細を提供するログ ファイルを作成したり、1 つまたはすべてのプロジェクト コレクションのジョブを再試行したりできます。

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]

前提条件

jobs コマンドを使用するには、Azure DevOps Administrators セキュリティ グループのメンバーである必要があります。 詳細については、「 Azure DevOps Server のアクセス許可リファレンス」を参照してください。

注釈

ジョブを対話形式で再試行するには、Azure DevOps の管理コンソールを開き、コレクションの [状態] タブを選択し、[ 再試行ジョブ] を選択します。 詳細については、「 Azure DevOps 管理コンソールを開く」を参照してください。

例

次の例では、Azure DevOps Server の Contoso Summer Intern Projects プロジェクト コレクションの最新のジョブ アクティビティを一覧表示するログ ファイルを作成する方法を示します。

TfsConfig jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"

offlineDetach コマンドを使用して、オフライン コレクション データベースをデタッチされたオフライン コレクション データベースにします。

TfsConfig offlineDetach /configurationDB:<databaseName>
    /collectionDB:<databaseName>

前提条件

offlineDetach コマンドを使用するには:

• 指定した SQL Server インスタンスの sysadmin ロールのメンバーである必要があります。
• TFSConfig ツールのバージョンは、Azure DevOps Server データベースのバージョンと一致している必要があります。

注釈

このコマンドは、指定されたコレクション データベースのスキーマを変更し、Azure DevOps Server デプロイで使用されているデータベースに対して実行しないでください。 データベースが Azure DevOps Server のデプロイで使用されている場合は、代わりに TfsConfig collection /detach を使用します。

このコマンドは、同じ Azure DevOps Server デプロイに含まれる他のコレクション データベースを復元せずに、バックアップから個々のコレクション データベースを復元する必要がある場合に便利です。 これまでは、完全で一貫性のあるデータベースセット (構成とすべてのコレクション) をステージング環境に復元し、それらのデータベースを使用して Azure DevOps Server デプロイを構成し、関心のあるコレクションをデタッチする必要があります。

代わりに、構成データベースと対象のコレクション データベースの一貫性のあるコピーを復元し、 offlineDetach コマンドを実行できるようになりました。 デタッチされたコレクション データベースは、適切なバージョンで任意の Azure DevOps Server デプロイにアタッチできます。

例

次の例では、TFS_PrimaryCollection という名前の構成データベースを使用して、TFS_Configurationという名前のコレクション データベースをデタッチし、両方の SQL インスタンスを名前付きインスタンス ContosoTemp 上の Backups という名前のサーバーで実行する方法を示します。

TfsConfig offlineDetach /configurationDB:ContosoTemp\Backups;TFS_Configuration /collectionDB:ContosoTemp\Backups;TFS_PrimaryCollection

プロキシ コマンドを使用して、Azure DevOps プロキシ サーバーで使用される設定を更新または変更できます。 Azure DevOps Proxy Server では、分散チームの場所でダウンロードしたバージョン管理ファイルのキャッシュを管理することで、分散チームがバージョン管理を使用するためのサポートが提供されます。 Azure DevOps プロキシ サーバーを構成することで、ワイド エリア接続全体で必要な帯域幅を大幅に削減できます。 さらに、バージョン ファイルのダウンロードとキャッシュを管理する必要はありません。ファイルの管理は、ファイルを使用している開発者に対して透過的です。 一方、メタデータ交換とファイルのアップロードは引き続き Azure DevOps Server に表示されます。 Azure DevOps Services を使用して開発プロジェクトをクラウドでホストする場合は、Proxy コマンドを使用して、ホストされているコレクション内のプロジェクトのキャッシュを管理するだけでなく、そのサービスで使用される設定の一部を管理することもできます。

Azure DevOps プロキシ サーバーのインストールとプロキシの初期構成の詳細については、

「方法: Azure DevOps プロキシ サーバーをインストールし、リモート サイトを設定する」を参照してください。 クライアント コンピューターでのプロキシの構成の詳細については、「 Azure DevOps Version Control コマンド リファレンス」を参照してください。

TfsConfig proxy /add|delete|change [/Collection:<teamProjectCollectionURL> /account:<accountName>]
	/Server:<TeamFoundationServerURL> [/inputs:Key1=Value1; Key2=Value2;...] [/continue]

前提条件

プロキシ コマンドを使用するには、Azure DevOps Administrators セキュリティ グループのメンバーであり、プロキシ サーバーの管理者である必要があります。 詳細については、「Azure DevOps Server のアクセス許可リファレンス」を参照してください。

注釈

プロキシ コマンドを使用して、Azure DevOps サーバー プロキシの既存の構成を更新します。 プロキシの初期インストールと構成には proxy コマンドを使用できません。

例示

次の例は、 FABRIKAM という名前の Azure DevOps Server デプロイをプロキシ リストに追加する方法を示しています。

TfsConfig proxy /add /Server:http://www.fabrikam.com:8080/tfs 

次の例では、 個人用アクセス トークン を使用して認証を行い、Azure DevOps Services でホストされているプロジェクト コレクションをプロキシ リストに追加する方法を示します。 このトークンは、プロキシを Azure DevOps Services アカウントに登録するためにのみ使用されます。既定のサービス アカウントは、プロキシの実行に引き続き使用されます。 このパラメーターは、ログイン プロンプトを必要とせずに Azure DevOps Services へのプロキシの登録をサポートするために、TFS 2018 Update 1 で追加されました。

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver

次の例は、プロジェクト コレクションをプロキシ リストに追加する方法を示しています。 この例では、個人用アクセス トークンを使用して、 /Collection パラメーターで指定されたコレクションに対する認証を行います。 使用する個人用アクセス トークンは、 c:\PersonalAccessToken.txtのファイルに保存されます。

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/PersonalAccessTokenFile:c:\PersonalAccessToken.txt

次の例は、Azure DevOps Services でホストされているプロジェクト コレクションのプロキシによって使用されるサービス アカウントを変更する方法を示しています。 コレクションには PhoneSaver という名前が付けられ、Azure DevOps Services に使用されるアカウント名が HelenaPetersen.fabrikam.comされ、プロキシで使用されるサービス アカウントが My Proxy Service Accountに変更されます。 アカウント名にはスペースが含まれているため、名前を囲むには引用符が使用されます。

TfsConfig proxy /change /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/account:"My Proxy Service Account"

次の例は、GVFS で使用する Git リポジトリを追加する方法を示しています。

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver /inputs:GvfsProjectName=PhoneSaver;GvfsRepositoryName=AnotherRepository

rebuildWarehouse コマンドを使用して、Azure DevOps Server で使用される SQL Server Reporting Services および SQL Server Analysis Services データベースを再構築できます。

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]

前提条件

rebuildWarehouse コマンドを使用するには、次のグループのメンバーである必要があります。

• Azure DevOps の管理コンソールを実行しているサーバーまたは複数のサーバー上の Azure DevOps Administrators セキュリティ グループと Administrators セキュリティ グループ

• Azure DevOps Server のデータベースをホストする SQL Server のインスタンスを実行しているサーバー上の sysadmin グループ

詳細については、「 Azure DevOps Server のアクセス許可リファレンス」を参照してください。

注釈

このコマンドは、プロジェクト コレクションの移動または分割、データの復元、または配置の構成の変更時に使用できます。

これらのデータベースの再構築を対話形式で開始するには、Azure DevOps の管理コンソールでレポート ノードを使用します。 詳細については、「 Azure DevOps 管理コンソールを開く」を参照してください。

例

次の例は、Azure DevOps Server のデプロイのために Analysis Services データベースを再構築する方法を示しています。

TfsConfig rebuildWarehouse /analysisServices

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.
    The Analysis Services database was successfully rebuilt.

registerDB を使用して、Azure DevOps Server で構成データベースをホストするサーバーの名前を更新します。 このコマンドは、構成データベースを新しいハードウェアに復元するとき、またはデプロイのドメインを変更するときに使用できます。

TfsConfig registerDB /sqlInstance:<serverName> /databaseName:<databaseName>

前提条件

registerDB コマンドを使用するには、Azure DevOps のアプリケーション層サーバーの Azure DevOps Administrators グループのメンバーであり、Azure DevOps のデータ層サーバー上の SQL Server の sysadmin グループのメンバーである必要があります。 詳細については、「 Azure DevOps Server のアクセス許可リファレンス」を参照してください。

注釈

このコマンドを使用する前に、Azure DevOps Server のデータベースをバックアップします。

registerDB コマンドを正常に実行するには、次のアプリケーション プールとプログラムが実行されている必要があります。

• Azure DevOps Server アプリケーション プール (アプリケーション プール)
• ReportServer (アプリケーション プール)
• SQL Server Reporting Services (プログラム)

このコマンドを正しく動作させるには、構成データベースの正確な名前またはアドレスを指定する必要があります。 このデータベースが格納されているサーバーを変更する必要がある場合は、Azure DevOps Server が新しい場所を指していることを確認する必要があります。

例

次の例では、AZURE DevOps Server を、SQL Server インスタンス ContosoMainのサーバー TeamDatabasesにある構成データベースにリダイレクトします。

TfsConfig registerDB /SQLInstance:ContosoMain\TeamDatabases /databaseName:Tfs_Configuration

remapDBs コマンドは、Azure DevOps Server が複数のサーバーに格納されていて、デプロイの構成を復元、移動、またはその他の方法で変更する場合に、そのデータベースにリダイレクトします。 たとえば、構成データベースとは別のサーバーでホストされている場合は、プロジェクト コレクション用のデータベースに Azure DevOps Server をリダイレクトする必要があります。 これらのデータベースが構成データベースとは別のサーバーまたはインスタンスでホストされている場合は、SQL Server Analysis Services または SQL Server Reporting Services を実行しているサーバーに Azure DevOps Server をリダイレクトする必要もあります。

TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
	[/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
	[/preview] [/continue]

前提条件

remapDBs コマンドを使用するには、Azure DevOps Administrators セキュリティ グループのメンバーであり、Azure DevOps Server で使用されるすべての SQL Server データベースの sysadmin セキュリティ グループのメンバーである必要があります。 詳細については、「 Azure DevOps Server のアクセス許可リファレンス」を参照してください。

注釈

remapDBs コマンドを使用して、元のインストールのサーバーとインスタンスから SQL Server のさまざまなサーバーとインスタンスを使用するように Azure DevOps Server を再構成します。

例

次の例は、Azure DevOps Server を構成データベース TFS_Configurationにリダイレクトする方法を示しています。 このデータベースは、名前付きインスタンス ContosoMain上のTeamDatabasesでホストされます。 そのプロジェクト コレクション データベースは、 ContosoMain\TeamDatabases と既定のインスタンスの両方に Contoso2に格納されます。

TfsConfig remapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
	/SQLInstances:ContosoMain\TeamDatabases,Contoso2

repairJobQueue コマンドを使用して、デプロイおよびコレクション ホストの実行が停止したスケジュールされたジョブを修正します。

TfsConfig repairJobQueue

前提条件

repairJobQueue コマンドを使用するには、TfsConfig を実行しているコンピューターのローカル管理者グループのメンバーである必要があります。 また、Azure DevOps Server デプロイで使用されるすべての SQL Server インスタンスの sysadmin セキュリティ ロールのメンバーである必要があります。

注釈

スケジュールされたジョブが実行されていないことに気付いた場合は、通常 repairJobQueue コマンドを使用します。
このコマンドは引数を受け取らず、Azure DevOps Server のデプロイを構成する必要があります。

例

TfsConfig repairJobQueue

settings コマンドを使用すると、通知インターフェイスと Azure DevOps Server のサーバー アドレスで使用される UNIFORM Resource Locator (URL) への変更を自動化できます。 既定では、通知インターフェイスの URL とサーバー URL は Azure DevOps Server で一致しますが、個別の URL を構成できます。 たとえば、Azure DevOps Server によって生成される自動電子メールに別の URL を使用できます。 アプリケーション層からこのツールを実行して、すべてのサーバーが新しい URL を使用するように更新する必要があります。

これらの URL を対話形式で変更したり、現在の設定を表示したりするには、Azure DevOps の管理コンソールを使用できます。 管理タスクのクイック リファレンスを参照してください。

TfsConfig settings [/publicURL:URL]

前提条件

アプリケーション層サーバーの Azure DevOps Administrators セキュリティ グループと Administrators グループのメンバーである必要があります。 詳細については、「 Azure DevOps Server の管理者アクセス許可を設定する」を参照してください。

注釈

settings コマンドは、Azure DevOps Server のデプロイでのサーバー間通信の接続情報を変更します。 /publicURL で指定する URL は、展開内のすべてのサーバーで使用できる必要があります。

例

次の例では、NotificationURL の値を http://contoso.example.com/tfs に変更し、ServerURL の値を http://contoso.example.com:8080/tfs に変更します。

TfsConfig settings /publicURL:http://contoso.example.com:8080/tfs

最新バージョンの Azure DevOps Server にアップグレードすると、システムはテスト計画やスイートを含むテスト管理コンポーネントのアップグレードを自動的に試みます。

自動移行が失敗した場合は、 TCM コマンドを使用して、テスト 計画とテスト スイートをそれぞれの作業項目の種類 (WIT) に手動でアップグレードします。

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

前提条件

Team Foundation Administrators セキュリティ グループのメンバーであり、アプリケーション層サーバーの管理者である必要があります。

「Azure DevOps Server の管理者アクセス許可を設定する」を参照してください。

注釈

このコマンドを使用するには、アプリケーション層サーバーを最新バージョンの Azure DevOps Server 2019 にアップグレードする必要があります。

TCM コマンドを使用するには、まずテスト計画作業項目定義とテスト計画カテゴリをプロジェクトにインポートする必要があります。

移行の詳細と、このコマンドを使用するタイミングについては、 テスト管理をサポートするための手動更新を参照してください。

TCM コマンドは、個々のプロジェクトに適用されます。 複数のプロジェクトでテスト計画をアップグレードする必要がある場合は、各プロジェクトに対して個別に実行する必要があります。

Azure DevOps Server のツール ディレクトリから TCM コマンドを実行する必要があります。 既定では、その場所は drive:\%programfiles%\TFS 12.0\Tools です。

TCM コマンドは、既存のテスト データの自動移行が失敗した場合にのみ使用します。

移行の詳細と、このコマンドを使用するタイミングについては、 テスト管理をサポートするための手動更新プログラムを参照してください。 サーバーのアップグレードが発生する前に定義されたテスト 計画またはテスト スイートにアクセスできない場合は、 TFSConfig TCM upgradeStatus を実行して移行の状態を確認します。

個々のプロジェクトに対して TCM コマンドを実行します。 複数のプロジェクトをアップグレードする必要がある場合は、各プロジェクトに対して順番に実行する必要があります。

例示

次の例は、既定のプロジェクト コレクション (DefaultCollection) でホストされている Fabrikam Fiber プロジェクトのテスト 計画アップグレードの状態を確認する方法を示しています。

tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"

コマンドの可用性: Azure DevOps Server 2019

無人セットアップ コマンドは、Azure DevOps Server と構成プロセスに慣れているユーザー、および異なるマシンに Azure DevOps Server をインストールする必要があるユーザーを対象に設計されています。

たとえば、Azure DevOps Build を使用する場合は、 無人コマンド を使用して、同じ構成ファイルを使用して複数のビルド サーバーをインストールできます。

/create オプションを使用して無人ファイルを作成します。 このファイルは、Azure DevOps Server インストールのすべての構成パラメーターを定義します。 次に、 /configure オプションを使用して、実際に構成を実行します。

このプロセスを使用すると、インストール プロセス中に入力を提供することなく、Azure DevOps Server を最初から最後まで構成できます。 複数のインストールの場合、これは、複数のサーバー間でまったく同じ構成パラメーターが使用されるようにするのにも役立ちます。

TfsConfig unattend /create|configure /type:InstallType /unattendfile:ConfigurationFileName 
    [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]

前提条件

• ソフトウェアをインストールするコンピューターの Administrators グループのメンバーである必要があります。

• インストールの種類によっては、追加の管理者権限が必要になる場合もあります。

たとえば、 無人コマンド を使用して Azure DevOps Server をインストールする場合は、Azure DevOps Server をサポートする SQL Server のインスタンス上の sysadmin グループのメンバーである必要があります。 詳細については、「 Azure DevOps Server にサーバー レベルの管理者を追加する」の Q & A セクションを参照してください。

注釈

無人コマンドを使用して Azure DevOps Server を構成する前に、デプロイの一部として使用するサービス アカウントを作成する必要があります。 選択したインストールの種類の前提条件ソフトウェアもインストールする必要があります。 これには、Azure DevOps Server 自体が含まれます。 Azure DevOps Server をインストールする必要がありますが、 無人コマンド によって自動的に構成されるため、構成する必要はありません。

Unattend コマンドは、Azure DevOps Server コンポーネントを構成します。 ソフトウェアの初期インストールは実行されません。 これは、ビットがコンピュータに存在した後、あなたの仕様に従ってソフトウェアを構成します。

例示

次の例は、Azure DevOps Server の基本的なインストール用の無人セットアップ ファイルを作成する方法を示しています。

TfsConfig unattend /create /type:basic /unattendfile:configTFSBasic.ini

この例では、コマンドが実行されるディレクトリに無人インストールファイルが作成されます。 ログ ファイルはコマンドの一部として作成され、コマンドの実行の一部としてファイルの場所がコマンドで返されます。

次の例は、構成時に GVFS で使用する Git リポジトリを指定する方法を示しています。

TfsConfig unattend /configure /type:proxy /inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection;GvfsProjectName=Fabrikam-Fiber-Git;GvfsRepositoryName=TestGit

次の例は、Azure DevOps プロキシ サーバーの構成用の無人セットアップ ファイルを作成する方法を示しています。

TfsConfig unattend /create /type:proxy "/inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection" /unattendFile:c:\unattend.txt

次の例では、ビルド サービス アカウントとして FabrikamFiber\BuildSVC を使用してサーバー上に Azure DevOps Server Build の構成用の無人セットアップ ファイルを作成し、その無人セットアップ ファイルを使用して Azure DevOps Server Build を構成する方法を示します。

TfsConfig unattend /create /type:build /unattendfile:configTFSBuild.ini
    /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

最初のコマンドは次を返します。

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203133.log

2 番目のコマンドは、Azure DevOps Build が FabrikamFiberTFS 構成されたサーバーの名前や、コントローラー DefaultCollectionに関連付けられているプロジェクト コレクションなど、次の情報を返します。

    Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
    Copyright (c) Microsoft Corporation. All rights reserved.

    Command: unattend

    ---------------------------------------------
            Inputs:
    ---------------------------------------------

    Feedback
            Send Feedback: True

    Build Resources
            Configuration Type: create
            Agent Count: 1
            New Controller Name: FabrikamFiberTFS - Controller
            Clean Up Resources: False

    Project Collection
            Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

    Windows Service
            Service Account: FabrikamFiber\BuildSVC
            Service Password: ********

    Advanced Settings *
            Port: 9191

    ---------------------------------------------
            Running Readiness Checks
    ---------------------------------------------

    [1/2] System Verifications
    [2/2] Build Service Verifications

    ---------------------------------------------
            Configuring
    ---------------------------------------------

            root
    [1/4] Install Team Foundation Build Service
            Installing Windows services ...
            Adding service account to groups ...
            Setting ACL on a windows service
    [2/4] Enable Event Logging
            Adding event log sources ...
            Token replace a config file
            RegisterBuildEtwProvider
            Configuring ETW event sources ...
    [3/4] Register with Team Foundation Server
            Registering the build service
    [4/4] Start Team Foundation Build Service
            StartBuildHost
            Starting Windows services ...
            Marking feature configured status
    [Info] [Register with Team Foundation Server] Firewall exception added for port
    9191

    TeamBuild completed successfully.
    Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

ziplogs コマンドは、ログを収集し、ProgramData\Microsoft\Azure DevOps\Server Configurationで zip をドロップするように設計されています。

TfsConfig zipLogs

TfsConfig zipLogs