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

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

注意

Azure DevOps Server は、以前は Visual Studio Team Foundation Server という名前でした。

TFSConfig コマンドラインツールを使用すると、Azure DevOps のオンプレミスのデプロイに対してさまざまな管理操作を実行できます。

TFSConfig は、Azure DevOps Server がインストールされている任意のコンピューターから実行できます。

重要

コンテンツ バージョン セレクター

プラットフォームで利用可能なコンテンツを表示するには、目次の上にあるバージョン セレクターから、この記事の正しいバージョンを確実に選択します。 機能のサポートは、Azure DevOps Services で作業しているか、Team Foundation Server (TFS) から名前が変更された Azure DevOps Server のオンプレミス バージョンで作業しているかによって異なります。

使用しているオンプレミスのバージョンについては、「使用しているプラットフォームまたはバージョン」を参照してください

注意

TFS 2010 以前のバージョンでは、 Tfsadminutils コマンドラインツールでこれらのコマンドのいくつかを使用できます。

コマンドラインツールの場所

Azure DevOps コマンドラインツールは、Azure DevOps アプリケーション層サーバーの/tools ディレクトリにインストールされます。

  • Azure DevOps Server 2020: %programfiles%\Azure DevOps Server 2020\Tools
  • Azure DevOps Server 2019: %programfiles%\Azure DevOps Server 2019\Tools
  • TFS 2018: %programfiles%\Microsoft Team Foundation Server 2018\Tools
  • TFS 2017: %programfiles%\Microsoft Team Foundation Server 15.0\Tools
  • TFS 2015: %programfiles%\Microsoft Team Foundation Server 14.0\Tools
  • TFS 2013: %programfiles%\Microsoft Team Foundation Server 12.0\Tools
  • TFS 2012: %programfiles%\Microsoft Team Foundation Server 11.0\Tools
  • TFS 2010: %programfiles%\Microsoft Team Foundation Server 2010\Tools

前提条件

多くのコマンドを正しく動作させるには、 tfsconfig が TFS 配置の一部であるさまざまなサーバーとサービスに接続できる必要があります。また、 tfsconfig を実行するユーザーは、これらの同じサーバーおよびサービスに対する管理権限を持っている必要があります。 特定のコマンドの要件を以下に示します。

実行中のユーザーが管理者資格情報を持っている場合でも、多くの TFSConfig コマンドを管理者特権でのコマンドプロンプトから実行する必要があります。 管理者特権でのコマンドプロンプトを開くには、[スタート] ボタンをクリックし、[コマンドプロンプト] を右クリックして、[管理者として実行] をクリックします。 詳細については、「 ユーザーアカウント制御」を参照してください。

Azure DevOps Server の管理コンソールを使用して、管理操作を対話的に実行することもできます。 「 管理タスクのクイックリファレンス」を参照してください。

コマンドを一覧表示してヘルプを表示する

TFSConfig コマンドの完全な一覧を表示するには、 help コマンドを使用します。

TFSConfig help

個々のコマンドのヘルプを表示する には、ヘルプコマンドを 使用して、ヘルプを表示するコマンドの名前を指定します。 たとえば、 accounts コマンドのヘルプを表示するには、次のようにします。

TFSConfig help accounts

アカウント

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

  • 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]
Operation 説明
UpdatePassword サービス アカウントとして使用されているアカウントのパスワードを変更します。 指定されたアカウントとして実行される既存のアカウントとすべての accountTypes を変更します。
変更 サービス アカウントとして使用するアカウントを変更します。 必要なリソースとグループに新しいアカウントを追加し、必要なアクセス許可を付与して、サービスを使用するように設定します。 これによって、リソースから古いアカウントが削除されることはありません。

AccountType オプションを使用しない場合は、アプリケーション層のサービスアカウントが変更されます。
追加 では、必要なリソースに新しいアカウントのみが追加されます。 NLB のシナリオに役立ちます。 一部のコレクションに到達できない場合は、continue フラグを使用します。 後で追加を実行して、失敗したコレクションを更新することができます。 アカウントをサービス アカウントとして使用するために必要なグループにアカウントを追加します。
オン は、既にリソースに追加されているアカウントを使用するようにサービスを設定します。 NLB のシナリオに役立ちます。
削除 すべてのリソースからアカウントを削除します。 アカウントを削除する場合は、他のサーバーが拒否されたサービスを拒否する可能性があるため、予防措置を使用する必要があります。
ResetOwner 移動、複製、またはディザスターリカバリーの一環としてデータベースを復元する場合、データベース所有者は、サーバーを復元する管理者に切り替えることができます。 このオプションでは、すべてのデータベースを反復処理し、dbo ログインを現在の所有者に設定します。
AccountType 説明
AdminConsole 管理コンソールのユーザーは、コンソールを使用するために、さまざまなリソースに対して最小限のアクセス許可が付与されているユーザーです。
ApplicationTier コア web サービスの appPool でサービスアカウントを変更します。 TFSService
プロキシ プロキシ web サービスの appPool でサービスアカウントを変更します。 TFSProxy
ReportingDataSource レポートデータにアクセスするためにレポートが使用するアカウントを変更します。 TFSReports

既定値は Applicationtier です。

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

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

注意

アカウントは domainName\userName 形式である必要があります。 システムアカウントの場合は、完全なアカウント名 (たとえば、"NT Authority\Network Service") を引用符で囲む必要があります。 システムアカウントにはパスワードは必要ありません。

パラメーター 説明
Account 参照されるアカウントの種類 (たとえば、 /AccountType: ApplicationTier) に追加、変更、または削除するアカウントの名前を指定します。
パスワード サービス アカウントのパスワードを指定します。 このパラメーターは、システム アカウント、または Network Service などのパスワードがないアカウントを使用している場合は省略可能です。
sqlInstance /ResetOwnerでのみ使用されます。

既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前とインスタンスの名前を指定します。 名前とインスタンスは次の形式で指定する必要があります。

Servername\instancename
databaseName /ResetOwnerでのみ使用されます。

所有者を変更するデータベースの名前を指定します。 このコマンドを使って、コマンドを実行するアカウントに指定するデータベースの所有権をリセットします。
continue コマンドを実行するときに利用できないすべてのグループを更新します。 通常、このオプションは、NLB のシナリオで使用されます。

前提条件

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

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

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

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

注釈

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

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

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

Reporting 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名前付きインスタンスの SQL Server のデータベースの所有権を、コマンドを実行している ContosoMain TeamDatabases ユーザーアカウントに変更します。

注意

このコマンドを使用するときに、データベースの所有者として設定するアカウントを指定することはできません。 所有者は、コマンドを実行するアカウントに設定されます。

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

これらの TFS サービスアカウントを管理するには、 Accounts コマンドを使用します。

  • TFS サービスアカウント
  • 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] [/usesqlalwayson]
オプション 説明
/change サービス アカウントとして使用するアカウントを変更します。 このオプションを選択すると、指定したアカウントが必要なすべてのグループに追加され、可能であれば前提条件が付与され、アカウントを使用するようにサービスが設定されます。 このオプションで /AccountType オプションを使用しない場合は、アプリケーション層のサービスアカウントが変更されます。
/add アカウントをサービス アカウントとして使用するために必要なグループにアカウントを追加します。 このオプションでは、指定したアカウントを必要なグループに追加し、(可能な場合は) サービス アカウントの役割を果たすために必要なアクセス許可を付与します。 ただし、このオプションでは、サービス アカウントとして使用するアカウントは変更されません。 通常、このオプションは、ネットワーク負荷分散 (NLB) のシナリオで使用されます。 一部のサービスまたはデータベースがご使用の環境で使用できない可能性がある場合は、このオプションに /continue を付けて使用します。
/set アカウントをサービス アカウントとして設定します。 このオプションでは、どのグループにもアカウントを追加しません。 したがって、このオプションは、必要なグループに追加済みで必要なアクセス許可があるアカウントにのみ使用する必要があります。 通常、このオプションは、NLB のシナリオで使用されます。
/delete 指定したアカウントの種類からアカウントを削除します。 このオプションでは、指定したアカウントを必要なグループから削除し、(可能な場合は) サービス アカウントの役割を果たすために必要なアクセス許可を削除します。 ただし、このオプションでは、サービス アカウントとして使用するアカウントは変更されません。 配置内のサーバーが現在サービス アカウントとして使用しているアカウントに対して、このオプションを使用していないことを確認してください。
/ResetOwner Azure DevOps Server が使用するデータベースの所有権を、このコマンドの実行に使用しているアカウントに変更します。 このオプションでは、すべてのデータベースを反復処理し、このコマンドの実行に使用しているアカウントに dbo ログインを設定します。 配置を移動または復元するときに、このオプションを使用する必要がある場合があります。
/UpdatePassword サービス アカウントとして使用されているアカウントのパスワードを変更します。 このオプションを選択すると、そのアカウントを使用する Azure DevOps Server のすべてのサービスに対して指定したアカウントのパスワードが更新されます。
/AccountType: {AdminConsole |ApplicationTier |ReportingDataSource |Rpcproxy
  • AdminConsole: Azure DevOps (AdminConsole) の管理コンソールを開いて使用するために必要な最小限のアクセス許可を持つユーザーのグループ
  • Applicationtier: Azure DevOps Server (TFSService) に使用されるサービスアカウント
  • Reportingdatasource: Reporting Services (TFSReports) のデータソースアカウント
  • プロキシ: Azure DevOps Server プロキシ (tfsproxy) のサービスアカウント

既定値は ApplicationTier です。

アカウント (& a):AccountName 参照されるアカウントの種類 (たとえば、 /AccountType: ApplicationTier) に追加、変更、または削除するアカウントの名前を指定します。 次のいずれかの形式でアカウントを指定してください: Computer\AccountName. Network Service や Local System などのシステム アカウントを使用する場合は、コンピューター\アカウント名 形式を使用します。 システム アカウントの指定方法の詳細については、このトピックで後述する使用例を参照してください。
/Password: 入力 サービス アカウントのパスワードを指定します。

注: システムアカウントまたはパスワードを持たないアカウント (Network Service など) を使用している場合、このパラメーターは省略可能です。
/SQLInstance: Server /ResetOwnerでのみ使用されます。 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前とインスタンスの名前を指定します。 名前とインスタンスは次の形式で指定する必要があります。

Servername\instancename
/DatabaseName: DatabaseName /ResetOwnerでのみ使用されます。 所有者を変更するデータベースの名前を指定します。 このコマンドを使って、コマンドを実行するアカウントに指定するデータベースの所有権をリセットします。
/continue コマンドを実行するときに利用できないすべてのグループを更新します。 通常、このオプションは、NLB のシナリオで使用されます。
/すべての alwayson /ResetOwner/SQLInstanceおよび/DatabaseNameを組み合わせて使用した場合にのみ使用されます。 データベースが SQL Server の AlwaysOn 可用性グループの一部であることを指定します。 このオプションを構成すると、接続文字列に MultiSubnetFailover が設定されます。

詳細については、「 AlwaysOn 可用性グループ (SQL Server)」を参照してください。

前提条件

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

  • Team Foundation 管理者セキュリティグループ
  • Azure DevOps Server インスタンスで使用されるすべての SQL Server インスタンスの sysadmin ロール。

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

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

注釈

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

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

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

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

TFSConfig Accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password

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

TFSConfig Accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

" _ TeamDatabases" という名前のインスタンスの "ContosoMain" SQL Server にある "TFS ウェアハウス" データベースの所有権を、コマンドを実行しているユーザーアカウントに変更します。

注意

このコマンドを使用するときに、データベースの所有者として設定するアカウントを指定することはできません。 所有者は、コマンドを実行するアカウントに設定されます。

TFSConfig Accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse

AddProjectReports

注意

Addprojectreports コマンドは、TFS 2017.1 以降のバージョンで使用できます。

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

TfsConfig addProjectReports /collection:<teamProjectCollectionUrl> /teamProject:<projectName> /template:<templateName>
    [/force]
オプション 説明
collection 必須です。 チームプロジェクトコレクションの URL。
teamproject 必須です。 チームプロジェクトの名前を指定します。
template 必須です。 プロセステンプレートの名前を指定します。 使用可能なオプションは、Agile、CMMI、およびスクラムです。
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

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

TfsConfig addProjectReports
        /collection:teamProjectCollectionUrl
        /teamProject:projectName
        /template:templateName
        [/force]
オプション 説明
/collection 必須です。 プロジェクトコレクションの URL。
/teamProject 必須です。 プロジェクトの名前を指定します。
/template 必須です。 プロセステンプレートの名前を指定します。 使用可能なオプションは、Agile、CMMI、およびスクラムです。
/force 省略可能。 既に存在する場合は、レポートを上書きすることを指定します。

前提条件

Addprojectreports コマンドを使用するには、 TFSConfig を実行し、レポート サービスにレポートをアップロードする権限が必要です。

注釈

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

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

  • プロジェクトは、Visual Studio からではなく、web ポータルで作成されました。
  • プロジェクトは 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

認証

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

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]
オプション 説明
/viewall Azure DevOps Server の現在の認証設定が表示されます。
/プロバイダー: {NTLM |ネゴシエーション Web サイト用に構成する認証プロバイダーを指定します。
  • NTLM: ntml 認証プロトコルを使用します。
  • Negotiate: Negotiate (Kerberos) 認証プロトコルを使用します。
/sitetype ネットワーク認証プロトコルを変更する web サイト (アプリケーション層またはプロキシ) を指定します。 アプリケーション層が既定値です。

前提条件

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

注釈

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

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

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

TFSConfig Authentication /viewAll

認証 コマンドを実行すると、TFS アプリケーション層またはプロキシ web サイトで使用されるネットワーク認証プロトコルが変更されます。

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]
オプション 説明
/viewall Azure DevOps Server の現在の認証設定が表示されます。
/プロバイダー: {NTLM |ネゴシエーション Web サイト用に構成する認証プロバイダーを指定します。
  • NTLM: ntml 認証プロトコルを使用します。
  • Negotiate: Negotiate (Kerberos) 認証プロトコルを使用します。
/sitetype ネットワーク認証プロトコルを変更する web サイト (アプリケーション層またはプロキシ) を指定します。 アプリケーション層が既定値です。

前提条件

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

注釈

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

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

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

TFSConfig Authentication /viewAll

証明書

[ 証明書 ] コマンドを使用して、HTTPS、secure sockets LAYER (SSL)、および証明書を利用する Azure DevOps Server の展開で、クライアント認証用に証明書を構成する方法を変更します。

TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]
オプション 説明
マシン 証明書の一覧が、現在のユーザーコンテキストではなくローカルコンピューターのコンテキストからのものであることを指定します。
無効化 (disable) クライアント認証証明書の設定が無効になることを指定します。
自動 証明書の一覧から証明書が自動的に選択されるように指定します。 [クライアント証明書の管理] ウィンドウは開きません。
noprompt [証明書] コマンドを実行したときに [クライアント証明書の管理] ウィンドウが開かないように指定します。
拇印 指定したサムプリントに一致する証明書が使用されることを指定します。 個々の拇印をコンマで区切ることで、複数の証明書を指定できます。

前提条件

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

注釈

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

Certificates コマンドを使用する前に、Azure DevOps Server の展開に含まれるサーバーで証明書を使用するように構成する必要があります。 詳細については、「 Azure DevOps Server に対して Secure Sockets Layer (SSL) を使用した HTTPS のセットアップ」を参照してください。

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

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

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

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

TfsConfig certificates /autoselect

[ 証明書 ] コマンドを使用して、HTTPS、secure sockets LAYER (SSL)、および証明書を利用する Azure DevOps Server の展開で、クライアント認証用に証明書を構成する方法を変更します。

TFSConfig Certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]
オプション 説明
/machine 証明書の一覧が、現在のユーザーコンテキストではなくローカルコンピューターのコンテキストからのものであることを指定します。
/disable クライアント認証証明書の設定が無効になることを指定します。
/autoSelect 証明書の一覧から証明書が自動的に選択されるように指定します。 [クライアント証明書の管理] ウィンドウは開きません。
/noprompt [証明書] コマンドを実行したときに [クライアント証明書の管理] ウィンドウが開かないように指定します。
/拇印: 拇印 指定したサムプリントに一致する証明書が使用されることを指定します。 個々の拇印をコンマで区切ることで、複数の証明書を指定できます。

前提条件

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

注釈

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

Certificates コマンドを使用する前に、Azure DevOps Server の展開に含まれるサーバーで証明書を使用するように構成する必要があります。 詳細については、「 Azure DevOps Server に対して Secure Sockets Layer (SSL) を使用した HTTPS のセットアップ」を参照してください。

[ 証明書 ] コマンドを使用して、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

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

通常、日常的な操作でこのコマンドを使用することはありませんが、次のような状況でこのコマンドを使用することもできます。

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

  • 実稼働環境に影響を及ぼすことがないように、重複する展開でソフトウェアの更新またはハードウェア構成をテストする必要がある。

  • テストラボまたは別の環境で新しいハードウェアへのデータベースの復元を完全にテストして、配置を復元できることを確認します。

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

注意

Changeserverid コマンドを元に戻すことはできません。 GUID を変更した後は、以前のバージョンのデータベースを復元する以外に、その変更を元に戻すことはできません。

TfsConfig changeServerID /sqlInstance:<serverName> /databaseName:<configurationDatabaseName>
    [/projectCollectionsOnly] [/configDBOnly] [/collectionName]
オプション 説明
sqlInstance 必須です。 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前とインスタンスの名前を指定します。 インスタンスを指定する場合は、の形式を使用する必要があり ServerName\InstanceName ます。
databaseName 必須です。 Azure DevOps Server の構成データベースの名前を指定します。 既定では、このデータベースの名前は TFS_ConfigurationDB です。
projectCollectionsOnly コレクションの Guid だけが変更されることを指定します。
configDBOnly 構成データベースの GUID のみが変更されることを指定します。
collectionName 特定のコレクションに対して新しいインスタンス id を作成するように指定しますが、Azure DevOps インスタンスおよびその他のコレクションには作成しません。

前提条件

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

注釈

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

次の例では、Azure DevOps Server の Contoso1 配置にあるすべてのデータベースの Guid を変更する方法を示します。この場合、構成データベースは、 ContosoMain SQL Server の名前付きインスタンスでという名前のサーバー上でホストされ TeamDatabases ます。

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

Changeserverid コマンドは、TFS のデータベースに関連付けられている guid を変更します。 Guid は、TFS の配置内で一意である必要があります。 複数のデータベースに同じ GUID がある場合、配置が不安定になったり、使用できなくなったりする可能性があります。 構成データベースの GUID、配置内のすべてのプロジェクトコレクションデータベースの guid、またはその両方を変更できます。 通常、日常的な操作でこのコマンドを使用することはありませんが、次のような状況でこのコマンドを使用することもできます。

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

  • 実稼働環境に影響を及ぼすことがないように、重複する展開でソフトウェアの更新またはハードウェア構成をテストする必要がある。

  • テストラボまたは別の環境で新しいハードウェアへのデータベースの復元を完全にテストして、配置を復元できることを確認します。

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

    注意

    ChangeServerID コマンドを元に戻すことはできません。 GUID を変更した後は、以前のバージョンのデータベースを復元する以外に、その変更を元に戻すことはできません。

    TFSConfig ChangeServerID/SQLInstance: ServerName/DatabaseName: ConfigurationDatabaseName [/projectの場合のみ] [/configdbonly] [/の場合は alwayson]

オプション 説明
/SQLInstance: ServerName 必須です。 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前とインスタンスの名前を指定します。 インスタンスを指定する場合は、次の形式を使用する必要があります。 ServerName\InstanceName
/Databasename: databasename 必須です。 Azure DevOps Server の構成データベースの名前を指定します。 既定では、このデータベースの名前は TFS_ConfigurationDB です。
/Projectコレクションのみ コレクションの Guid だけが変更されることを指定します。
/Configdbonly 構成データベースの GUID のみが変更されることを指定します。
/すべての alwayson データベースが SQL Server の AlwaysOn 可用性グループの一部であることを指定します。 このオプションを構成すると、接続文字列に MultiSubnetFailover が設定されます。

詳細については、「 AlwaysOn 可用性グループ (SQL Server)」を参照してください。

前提条件

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

注釈

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

次の例では、Azure DevOps Server の Contoso1 配置にあるすべてのデータベースの Guid を変更する方法を示します。この場合、構成データベースは、SQL Server の名前付きインスタンス "TeamDatabases" で "ContosoMain" という名前のサーバーでホストされます。

TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

CodeIndex

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>]
オプション 説明
indexingStatus コード インデックス作成サービスの状態と構成を表示します。
setIndexing on: すべての変更セットのインデックス作成を開始します。
off: すべての変更セットのインデックス作成を停止します。
keepupOnly: 以前に作成された変更セットのインデックス作成を停止し、新しい変更セットのインデックス作成のみを開始します。
ignoreList インデックスを作成しないコード ファイルとそのパスの一覧を指定します。

add: インデックスを作成しないファイルを無視ファイル リストに追加します。
remove: インデックスを作成するファイルを無視ファイル リストから削除します。
removeAll: 無視ファイル リストをクリアし、すべてのファイルのインデックス作成を開始します。
view: インデックスを作成しないすべてのファイルを表示します。
Serverpath: コードファイルへのパスを指定します。

ワイルドカード文字 (*) を、サーバー パスの先頭、末尾、または両端に使用できます。
listLargeFiles KB 単位で指定されたサイズを超えるファイルを指定された数だけ表示します。 その後で、/ignoreList オプションを使用して、これらのファイルをインデックス作成から除外することができます。

そのためには、 Update 3 で2013を Team Foundation Serverする必要があります。
すべて再インデックス 以前にインデックスを作成したデータをクリアし、インデックス作成を再び開始します。
destroyCodeIndex コード インデックスを削除し、すべてのインデックス データを削除します。 /noPrompt のオプションを使用する場合は、確認を要求されません。
一時 Datasizelimit 変更セットを処理するときに CodeLens が作成する一時データの量を制御します。 制限の既定値は 6 GB (更新プログラム 5 では 2 GB) です。

view: 現在のサイズ制限を表示します。
Sizeingbs: サイズ制限を変更します。
disable: サイズの制限を削除します。

CodeLens が新しい変更セットを処理する前に、この制限の検査が行われます。 一時データがこの制限を超える場合、CodeLens は過去の変更セット (新しい変更セットではない) の処理を一時停止します。 データがクリーンアップされ、この制限内に収まると、CodeLens は処理を再開します。 クリーンアップは 1 日に 1 度、自動的に行われます。 このことは、クリーンアップの実行が始まるまでは、一時データがこの制限を超えている可能性があることを意味します。

そのためには、 Update 4 で2013を Team Foundation Serverする必要があります。
Indexhistory 期間 変更履歴のインデックスを作成する期間を制御します。 これは、CodeLens の履歴の表示量に影響します。 制限の既定値は 12 か月です。 つまり、CodeLens が過去 12 か月間の変更履歴のみを表示するという意味です。

view: 現在の月数を表示します。
all: すべての変更履歴のインデックスを作成します。
Numberofmonths: 変更履歴のインデックス作成に使用する月数を変更します。

そのためには、 Update 4 で2013を Team Foundation Serverする必要があります。
collectionName CodeIndex コマンドを実行する対象のプロジェクト コレクションの名前を指定します。 /CollectionId を使用しない場合は必ず指定します。
collectionId CodeIndex コマンドを実行する対象のプロジェクト コレクションの ID 番号を指定します。 /CollectionNameを使用しない場合は必須

前提条件

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"

コマンドの可用性: TFS 2015 および TFS 2013

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]
オプション 説明

/indexingStatus

コード インデックス作成サービスの状態と構成を表示します。

/setIndexing:[on | Off | keepupOnly]

  • on: すべての変更セットのインデックス作成を開始します。

  • off: すべての変更セットのインデックス作成を停止します。

  • keepupOnly: 以前に作成された変更セットのインデックス作成を停止し、新しい変更セットのインデックス作成のみを開始します。

/ignorelist:[add | Remove | removeAll | View] serverpath

インデックスを作成しないコード ファイルとそのパスの一覧を指定します。

  • add: インデックスを作成しないファイルを無視ファイル リストに追加します。

  • remove: インデックスを作成するファイルを無視ファイル リストから削除します。

  • removeAll: 無視ファイル リストをクリアし、すべてのファイルのインデックス作成を開始します。

  • view: インデックスを作成しないすべてのファイルを表示します。

  • Serverpath: コードファイルへのパスを指定します。

    ワイルドカード文字 (*) を、サーバー パスの先頭、末尾、または両端に使用できます。

/listLargeFiles [/fileCount: fileCount /minSize: minSize]

KB 単位で指定されたサイズを超えるファイルを指定された数だけ表示します。 その後で、/ignoreList オプションを使用して、これらのファイルをインデックス作成から除外することができます。

そのためには、 Update 3 で2013を Team Foundation Serverする必要があります。

すべて再インデックス

以前にインデックスを作成したデータをクリアし、インデックス作成を再び開始します。

/destroycodeindex [/noPrompt]

コード インデックスを削除し、すべてのインデックス データを削除します。 /noPrompt のオプションを使用する場合は、確認を要求されません。

/一時 datasizelimit: [表示 | <Sizeingbs >|切り替える

変更セットを処理するときに CodeLens が作成する一時データの量を制御します。 制限の既定値は 6 GB (更新プログラム 5 では 2 GB) です。

  • view: 現在のサイズ制限を表示します。

  • Sizeingbs: サイズ制限を変更します。

  • disable: サイズの制限を削除します。

CodeLens が新しい変更セットを処理する前に、この制限の検査が行われます。 一時データがこの制限を超える場合、CodeLens は過去の変更セット (新しい変更セットではない) の処理を一時停止します。 データがクリーンアップされ、この制限内に収まると、CodeLens は処理を再開します。 クリーンアップは 1 日に 1 度、自動的に行われます。 このことは、クリーンアップの実行が始まるまでは、一時データがこの制限を超えている可能性があることを意味します。

そのためには、 Update 4 で2013を Team Foundation Serverする必要があります。

/indexhistory period: [view | all | <Numberofmonths >]

変更履歴のインデックスを作成する期間を制御します。 これは、CodeLens の履歴の表示量に影響します。 制限の既定値は 12 か月です。 つまり、CodeLens が過去 12 か月間の変更履歴のみを表示するという意味です。

  • view: 現在の月数を表示します。

  • all: すべての変更履歴のインデックスを作成します。

  • Numberofmonths: 変更履歴のインデックス作成に使用する月数を変更します。

そのためには、 Update 4 で2013を Team Foundation Serverする必要があります。

/collectionName: collectionName

CodeIndex コマンドを実行する対象のプロジェクト コレクションの名前を指定します。 /CollectionId を使用しない場合は必ず指定します。

/collectionid: collectionid

CodeIndex コマンドを実行する対象のプロジェクト コレクションの ID 番号を指定します。 /CollectionName を使用しない場合は必ず指定します。

前提条件

CodeIndex コマンドを使用するには、Team Foundation 管理者セキュリティ グループのメンバーである必要があります。 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 の配置からプロジェクトコレクションをアタッチ、デタッチ、または削除できます。 また、 collection コマンドを使用して、既存のコレクションのデータベースを複製し、名前を変更して、配置にアタッチすることもできます。 このプロセスはコレクションの複製と呼ばれることもあります。

TfsConfig collection {/attach | /create | /detach | /delete} [/collectionName:<collectionName>]
    [/description:<collectionDescription>]
    [/collectionDB:<serverName>;<databaseName>]
    [/processModel:Inheritance|Xml]
    [/reportingFolder:<reportingFolderPath>]
    [/clone] [/verify] [/continue]
オプション 説明
アタッチ /Detach/deleteも使用しない場合は必須です。 このオプションを指定する場合は、 /collectiondb オプションも使用する必要があります。 オプションとして、 /collectionName/clone をこのオプションと共に使用することもできます。 /Attachオプションを使用すると、指定したコレクションデータベースが Azure DevOps Server の配置に追加されます。
create コレクションを作成します。
分離 /Attach/deleteも使用しない場合は必須です。 このオプションを指定する場合は、 /collectionName オプションも使用する必要があります。 /Detachオプションを使用すると、指定したコレクションのデータベースが停止し、Azure DevOps Server の配置からコレクションがデタッチされます。
delete /Detach/attachも使用されていない場合は必須です。 このオプションを指定する場合は、 /collectionName オプションも使用する必要があります。 /Deleteオプションを使用すると、指定したコレクションのデータベースが停止し、コレクションは Azure DevOps Server から完全にデタッチされます。 このコレクション データベースはこの配置だけでなく、他のすべての配置に再アタッチできなくなります。
CollectionName プロジェクト コレクションの名前を指定します。 コレクションの名前にスペースが含まれている場合は、名前を引用符で囲む必要があります (たとえば、 " [マイコレクション] " )。 /Detachまたは/deleteのいずれかを使用する場合は必須です。 このオプションを /detach または /deleteと共に使用する場合は、デタッチまたは削除するコレクションを指定します。 このオプションを /attachと共に使用する場合は、コレクションの新しい名前を指定します。 このオプションを /attach/cloneの両方で使用する場合は、重複するコレクションの名前を指定します。
CollectionDB /Attachを使用する場合は必須です。 このオプションでは、SQL Server を実行しているサーバーの名前と、そのサーバーでホストされているコレクションデータベースの名前を指定します。
ServerName Azure DevOps Server の構成データベースをホストするサーバーの名前を指定します。また、既定のインスタンス以外のインスタンスを使用する場合は、インスタンスの名前を指定します。 インスタンスを指定する場合は、の形式を使用する必要があり ServerName\InstanceName ます。
DatabaseName 構成データベースの名前を指定します。 既定では、このデータベースの名前は TFS_ConfigurationDB です。
clone このオプションを指定すると、元のコレクションデータベースが SQL Server の複製としてアタッチされ、このデータベースが Azure DevOps Server にアタッチされます。 このオプションは、主にプロジェクトコレクションの分割の一部として使用されます。

ヒント

/Deleteオプションは、SQL Server からコレクションデータベースを削除しません。 Azure DevOps Server からコレクションデータベースを削除した後、SQL Server から手動でデータベースを削除できます。

前提条件

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

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

注釈

コレクションを対話的に管理したり、コレクションを作成したりするには、Azure DevOps の管理コンソールの [プロジェクトコレクション] ノードを使用します。 「 プロジェクトコレクションの管理」を参照してください。

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

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

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

TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName]
        [/collectionDB:ServerName;DatabaseName] [/clone]

パラメーター

オプション 説明
/attach /Detach/deleteも使用しない場合は必須です。 このオプションを指定する場合は、 /collectiondb オプションも使用する必要があります。 オプションとして、 /collectionName/clone をこのオプションと共に使用することもできます。 /Attachオプションを使用すると、指定したコレクションデータベースが Azure DevOps Server の配置に追加されます。
/detach /Attach/deleteも使用しない場合は必須です。 このオプションを指定する場合は、 /collectionName オプションも使用する必要があります。 /Detachオプションを使用すると、指定したコレクションのデータベースが停止し、Azure DevOps Server の配置からコレクションがデタッチされます。
/delete /Detach/attachも使用されていない場合は必須です。 このオプションを指定する場合は、 /collectionName オプションも使用する必要があります。 /Deleteオプションを使用すると、指定したコレクションのデータベースが停止し、コレクションは Azure DevOps Server から完全にデタッチされます。 このコレクション データベースはこの配置だけでなく、他のすべての配置に再アタッチできなくなります。

ヒント:/Deleteオプションは、SQL Server からコレクションデータベースを削除しません。 Azure DevOps Server からコレクションデータベースを削除した後、SQL Server から手動でデータベースを削除できます。
/CollectionName: CollectionName プロジェクト コレクションの名前を指定します。 コレクションの名前にスペースが含まれている場合は、名前を引用符で囲む必要があります (たとえば、 " [マイコレクション] " )。 /Detachまたは/deleteのいずれかを使用する場合は必須です。 このオプションを /detach または /deleteと共に使用する場合は、デタッチまたは削除するコレクションを指定します。 このオプションを /attachと共に使用する場合は、コレクションの新しい名前を指定します。 このオプションを /attach/cloneの両方で使用する場合は、重複するコレクションの名前を指定します。
/Collectiondb: ServerName; DatabaseName /Attachを使用する場合は必須です。 このオプションでは、SQL Server を実行しているサーバーの名前と、そのサーバーでホストされているコレクションデータベースの名前を指定します。
  • ServerName: Azure DevOps Server の構成データベースをホストするサーバーの名前、および既定のインスタンス以外のインスタンスを使用する場合は、インスタンスの名前を指定します。 インスタンスを指定する場合は、の形式を使用する必要があり ServerName\InstanceName ます。
  • DatabaseName: 構成データベースの名前を指定します。 既定では、このデータベースの名前は TFS_ConfigurationDB です。
/clone このオプションを指定すると、元のコレクションデータベースが SQL Server の複製としてアタッチされ、このデータベースが Azure DevOps Server にアタッチされます。 このオプションは、主にプロジェクトコレクションの分割の一部として使用されます。

前提条件

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

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

注釈

コレクションを対話的に管理したり、コレクションを作成したりするには、Azure DevOps の管理コンソールの [プロジェクトコレクション] ノードを使用します。 「 プロジェクトコレクションの管理」を参照してください。

次の例は、Azure DevOps Server の配置から "Contoso 夏インターンプロジェクト" プロジェクトコレクションを完全に削除する方法を示しています。

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 夏インターンプロジェクト" プロジェクトコレクションを複製し、"Contoso 冬インターンプロジェクト" という名前を付けて、複製されたコレクションを Azure DevOps Server の配置にアタッチする方法を示します。

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

ColumnStoreIndex

注意

コマンドの可用性: TFS 2015.2 以降のバージョンが必要です。

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

TfsConfig columnStoreIndex /enabled:<true|false>
    /sqlInstance:<serverName>
    /databaseName:<databaseName>
オプション 説明
enabled 指定された SQL インスタンスおよびデータベースの列ストアインデックスを有効または無効にするかどうかを指定します。
sqlInstance 列ストアインデックスが有効または無効になっているデータベースをホストするサーバーの名前、および既定値以外のインスタンスが使用されている場合は、インスタンスの名前を指定します。 インスタンスを指定する場合は、の形式を使用する必要があり ServerName\InstanceName ます。
databaseName 列ストアインデックスを有効または無効にするデータベースの名前を指定します。

前提条件

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

注釈

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

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

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

Columnstoreindex コマンドを使用して、TFS 配置で使用されるデータベースの列ストアインデックスを有効または無効にします。

TfsConfig columnStoreIndex /enabled:{true|false}
        /sqlInstance:ServerName
        /databaseName:DatabaseName
オプション 説明
/enabled 指定された SQL インスタンスおよびデータベースの列ストアインデックスを有効または無効にするかどうかを指定します。
/sqlInstance 列ストアインデックスが有効または無効になっているデータベースをホストするサーバーの名前、および既定値以外のインスタンスが使用されている場合は、インスタンスの名前を指定します。 インスタンスを指定する場合は、次の形式を使用する必要があります。 ServerName\InstanceName
/databaseName 列ストアインデックスを有効または無効にするデータベースの名前を指定します。

前提条件

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

注釈

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

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

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

ConfigureMail 既存の SMTP サーバーを使用して電子メールアラートを送信するように Azure DevOps Server を実行するサーバーを構成します。TfsConfig configureMail /Enabled:<true|false> /FromEmailAddress:<emailAddress> /SmtpHost:<SMTPHostName>### 前提条件ConfigureMail コマンドを使用するには、Azure DevOps アプリケーション層サーバーの Team Foundation 管理者セキュリティグループのメンバーである必要があります。 詳細については、「 Azure DevOps Server のアクセス許可のリファレンス」を参照してください。### 注釈管理コンソールを使用して、 SMTP サーバーを使用するように Azure DevOps Server を構成することもできます。### 例次の例では、from 電子メールアドレスをに、SMTP メールサーバーをとして構成するために使用される構文を示し TFS@contoso.com ContosoMailServer ます。TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer


DBCompression

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

TfsConfig dbCompression /pageCompression:[enable|disable]
    /sqlInstance:<serverName>
    /databaseName:<databaseName>
    [/rebuildNow [/offline]]
オプション 説明
pageCompression 指定された SQL インスタンスとデータベースに対して、ページの圧縮を有効にするか無効にするかを指定します。
sqlInstance ページの圧縮を有効または無効にするデータベースをホストするサーバーの名前を指定します。また、既定値以外のインスタンスを使用する場合は、インスタンスの名前を指定します。 インスタンスを指定する場合は、次の形式を使用する必要があります。 ServerName\InstanceName
databaseName ページの圧縮を有効または無効にするデータベースの名前を指定します。
rebuildNow 省略可能。 データベースインデックスを直ちに再構築する (または必要に応じて圧縮または圧縮解除する) かどうかを指定します。 使用しない場合、インデックスは毎週実行されるバックグラウンドジョブによって再構築されます。
offline 省略可能。 /RebuildNowとの組み合わせでのみ使用されます。 /Offlineが指定されていない場合、インデックスはオンラインで再構築されます。 /Offlineが指定されている場合、インデックスはオフラインで再構築されます。 これにより、他の操作がブロックされますが、オンラインインデックス再構築よりも高速な場合があります。

前提条件

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

注釈

圧縮がサポートされている SQL インスタンスからデータベースを移動する場合は、通常、 dbcompression コマンドを使用します。 この場合、データベースを正常に移動するには、圧縮を無効にしてすべてのインデックスを圧縮解除する必要があります。 同様に、圧縮がサポートされている SQL インスタンスにデータベースを戻す場合は、領域を節約するために圧縮を再度有効にする必要があります。

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

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

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

TFS 2012 以前のバージョンについては、「」を参照してください https://support.microsoft.com/kb/2712111

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

TFSConfig dbCompression /pageCompression:{enable|disable}
        /sqlInstance:ServerName
        /databaseName:DatabaseName
        [/rebuildNow [/offline]]
オプション 説明
/pageCompression 指定された SQL インスタンスとデータベースに対して、ページの圧縮を有効にするか無効にするかを指定します。
/sqlInstance ページの圧縮を有効または無効にするデータベースをホストするサーバーの名前を指定します。また、既定値以外のインスタンスを使用する場合は、インスタンスの名前を指定します。 インスタンスを指定する場合は、次の形式を使用する必要があります。 ServerName\InstanceName
/databaseName ページの圧縮を有効または無効にするデータベースの名前を指定します。
/rebuildNow 省略可能。 データベースインデックスを直ちに再構築する (または必要に応じて圧縮または圧縮解除する) かどうかを指定します。 使用しない場合、インデックスは毎週実行されるバックグラウンドジョブによって再構築されます。
/offline 省略可能。 /RebuildNowとの組み合わせでのみ使用されます。 /Offlineが指定されていない場合、インデックスはオンラインで再構築されます。 /Offlineが指定されている場合、インデックスはオフラインで再構築されます。 これにより、他の操作がブロックされますが、オンラインインデックス再構築よりも高速な場合があります。

前提条件

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

注釈

圧縮がサポートされている SQL インスタンスからデータベースを移動する場合は、通常、 dbcompression コマンドを使用します。 この場合、データベースを正常に移動するには、圧縮を無効にしてすべてのインデックスを圧縮解除する必要があります。 同様に、圧縮がサポートされている SQL インスタンスにデータベースを戻す場合は、領域を節約するために圧縮を再度有効にする必要があります。

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

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

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

DeleteTestResults

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

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]
オプション 説明
ageInDays 指定された日数を経過したテスト結果が削除またはプレビューされます。
sqlInstance テスト結果を削除またはプレビューする対象のデータベースをホストするサーバーの名前、および既定値以外のインスタンスが使用されている場合は、インスタンスの名前。 インスタンスを指定する場合は、の形式を使用する必要があり ServerName\InstanceName ます。
databaseName テスト結果が削除またはプレビューされているデータベースの名前。
省略可能。 削除するテスト結果の種類。 有効な値は、 自動手動、および すべてです。
preview 省略可能。 経過日数に基づいて削除されるテスト結果の数を表示しますが、これらの結果は削除しません。

前提条件

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

注釈

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

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

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

コマンドの可用性: TFS 2017 以降

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

TFSConfig DeleteTestResults /ageInDays:{number} 
    /sqlInstance:ServerName
    /databaseName:DatabaseName
    [/type:{automated|manual|all}]
    [/preview]
オプション 説明
/ageindays 指定された日数を経過したテスト結果が削除またはプレビューされます。
/sqlInstance テスト結果を削除またはプレビューする対象のデータベースをホストするサーバーの名前、および既定値以外のインスタンスが使用されている場合は、インスタンスの名前。 インスタンスを指定する場合は、次の形式を使用する必要があります。 ServerName\InstanceName
/databaseName テスト結果が削除またはプレビューされているデータベースの名前。
/type 省略可能。 削除するテスト結果の種類。 有効な値は、 自動手動、および すべてです。
/preview 省略可能。 経過日数に基づいて削除されるテスト結果の数を表示しますが、これらの結果は削除しません。

前提条件

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

注釈

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

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

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

DeploymentPool

Deploymentpool コマンドは、デプロイプール間ですべての配置グループを移行するように設計されています。

TfsConfig deploymentpool /migrateDeploymentGroups /fromPool:<source pool name> /toPool:<destination pool name>
オプション 説明
fromPool ソースプール名。
toPool 宛先プールの名前。

Identities

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

  • 配置のドメインを変更する

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

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

注意

同じ Active Directory フォレスト内でドメインを変更する場合、このコマンドを実行する必要はありません。 Azure DevOps Server は、同じフォレスト内の移動に対する SID の変更を自動的に処理します。

TfsConfig identities [/change /fromdomain:<domainName1> /todomain:<domainName2>
    [/account:<accountName> [/toaccount:<accountName>]] [/sqlInstance:<serverName> /databaseName:<databaseName>]
オプション 説明
change (変更) ID を一覧表示せず、変更するように指定します。
fromdomain /Changeを使用する場合に必要です。 変更する ID の元のドメインを指定します。 ワークグループ環境から変更する場合は、コンピューターの名前を指定します。
todomain /Changeを使用する場合に必要です。 ID の変更後のドメインを指定します。 ワークグループ環境に変更する場合は、コンピューターの名前を指定します。
account 一覧表示または変更する ID のアカウントの名前を指定します。
toaccount ID の変更先のアカウントの名前を指定します。
SQLInstance 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前とインスタンスの名前を指定します。 インスタンスを指定する場合は、次の形式を使用する必要があります。

ServerName\InstanceName
DatabaseName Azure DevOps Server の構成データベースの名前を指定します。

前提条件

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

注釈

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

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

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

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

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 ドメインから、ドメイン内の名前が一致するアカウントの Sid に変更する方法を示します ContosoPrime 。 一致するアカウント名のみ、SID が更新されます。 たとえば、 hholt アカウントがととして存在する場合、 Contoso1\hholt ContosoPrime\hholt アカウント SID はの sid に変更さ ContosoPrime\hholt れます。 アカウントが存在しない場合 ContosoPrime\hholt 、SID はに対して更新されません Contoso1\hholt

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

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

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

次の例では、 NT AUTHORITY\NETWORK SERVICE 展開のドメインをからに変更するときに Azure DevOps Server の展開で使用されるサービスアカウントの SID を変更する方法を示し Contoso1 ContosoPrime ます。 Network Service などのシステム アカウントを変更するには、2 段階のプロセスに従う必要があります。 まず、サービスアカウントをから NT AUTHORITY\NETWORK SERVICE 新しいドメインのドメインアカウントに変更 TempSVC してから、新しいドメインのサーバーでアカウントを NETWORK service に戻します。 構成データベースは、 ContosoMain SQL Server の名前付きインスタンス上にあるという名前のサーバーでホストされ 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"

Id コマンドは、TFS の配置に含まれるユーザーとグループのセキュリティ識別子 (SID) を一覧表示または変更します。 次のいずれかのシナリオでは、ユーザーおよびグループの SID を変更または更新する必要がある場合があります。

  • 配置のドメインを変更する

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

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

    注意

    同じ Active Directory フォレスト内でドメインを変更する場合、このコマンドを実行する必要はありません。 Azure DevOps Server は、同じフォレスト内の移動に対する SID の変更を自動的に処理します。

    TFSConfig Id [/change/fromdomain: DomainName1/todomain: DomainName2 [/account: AccountName] [/toaccount: AccountName]] [/sqlInstance: ServerName/databasename: DatabaseName] [/account: AccountName] [/? qlalwayson]

オプション 説明
/change ID を一覧表示せず、変更するように指定します。
/fromdomain: Tapi /Changeを使用する場合に必要です。 変更する ID の元のドメインを指定します。 ワークグループ環境から変更する場合は、コンピューターの名前を指定します。
/todomain: Tapi /Changeを使用する場合に必要です。 ID の変更後のドメインを指定します。 ワークグループ環境に変更する場合は、コンピューターの名前を指定します。
アカウント (& a):AccountName 一覧表示または変更する ID のアカウントの名前を指定します。
/toaccount: AccountName ID の変更先のアカウントの名前を指定します。
/SQLInstance: Server 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前とインスタンスの名前を指定します。 インスタンスを指定する場合は、次の形式を使用する必要があります。

ServerName\InstanceName
/DatabaseName: DatabaseName Azure DevOps Server の構成データベースの名前を指定します。
/すべての alwayson データベースが SQL Server の AlwaysOn 可用性グループの一部であることを指定します。 このオプションを構成すると、接続文字列に MultiSubnetFailover が設定されます。

詳細については、「 AlwaysOn 可用性グループ (SQL Server)」を参照してください。

前提条件

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

注釈

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

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

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

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

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 ドメインから、一致する名前を持つアカウントの Sid に変更する方法を示しています。 一致するアカウント名のみ、SID が更新されます。 たとえば、"hholt" アカウントが Contoso1 hholt およびとして存在する場合、アカウント SID は、"" \ \ の sid に変更され \ ます。 " \ Hholt" アカウントが存在しない場合、SID は Contoso1 hholt に対して更新されません \ 。

TFSConfig Identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

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

TFSConfig Identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

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

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"

ジョブ

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

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]
オプション 説明
retry /Dumplogを使用しない場合は必須です。 指定されたプロジェクトコレクションに対して最新のジョブが再試行さされることを指定します。 このオプションを使用する場合は、 /CollectionName または /CollectionID オプションも使用する必要があります。
dumplog /再試行を使用しない場合は必須です。 コレクションの最新のジョブの利用状況をログファイルに送信することを指定します。 このオプションを使用する場合は、 /CollectionName または /CollectionID オプションも使用する必要があります。
CollectionName /CollectionIDが使用されていない場合は必須です。 最新のジョブが再試行されるか (再試行)、ログに記録されるコレクションの名前を指定します (/dumplog)。 すべてのコレクションを指定する場合は、アスタリスク (*) を使用できます。
CollectionID /CollectionNameを使用しない場合は必須です。 最新のジョブが再試行されるか (再試行)、ログに記録されるコレクション (/dumplog) の識別番号を指定します。

前提条件

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"

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

TFSConfig Jobs /retry|dumplog [/CollectionName:CollectionName] [/CollectionID:ID]
オプション 説明
/retry /Dumplogを使用しない場合は必須です。 指定されたプロジェクトコレクションに対して最新のジョブが再試行さされることを指定します。 このオプションを使用する場合は、 /CollectionName または /CollectionID オプションも使用する必要があります。
/dumplog /再試行を使用しない場合は必須です。 コレクションの最新のジョブの利用状況をログファイルに送信することを指定します。 このオプションを使用する場合は、 /CollectionName または /CollectionID オプションも使用する必要があります。
/CollectionName: CollectionName /CollectionIDが使用されていない場合は必須です。 最新のジョブが再試行されるか (再試行)、ログに記録されるコレクションの名前を指定します (/dumplog)。 すべてのコレクションを指定する場合は、アスタリスク (*) を使用できます。
/CollectionID: 番号 /CollectionNameを使用しない場合は必須です。 最新のジョブが再試行されるか (再試行)、ログに記録されるコレクション (/dumplog) の識別番号を指定します。

前提条件

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

注釈

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

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

TFSConfig Jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"

ラボ/delete

TfsConfig Lab/delete オプションを使用して、指定したプロジェクトコレクションからすべてのグループホスト、ライブラリ共有、および環境を削除します。 既定では、System Center Virtual Machine Manager (SCVMM) に関連付けられているオブジェクトは削除されません。 コマンドラインに /External オプションを追加すると、プロジェクトコレクションと SCVMM からオブジェクトを削除できます。

TfsConfig Lab /Delete /CollectionName:collectionName [/External] [/NoPrompt]
オプション 説明
CollectionName: CollectionName 必須です。 Azure DevOps Server のアプリケーション層のプロジェクトコレクションの名前を指定します。
外部 省略可能。 指定すると、プロジェクトコレクション内のオブジェクトに加えて、SCVMM 内のライブラリ共有とホストグループが削除されます。 /External が指定されていない場合、 TfsConfig Lab/delete コマンドはプロジェクトコレクション内のオブジェクトのみを削除します。
NoPrompt 省略可能。 指定した場合、進行状況および成功の情報は表示されません。

注釈

プロジェクトコレクションのラボ構成をデタッチする場合は、 /delete コマンドを使用して、プロジェクトコレクションからラボアセットを削除します。 これは、ある Azure DevOps Server インスタンスから別のインスタンスにプロジェクトコレクションを移動する場合や、新しい Azure DevOps Server インスタンスが元のものとは異なる SCVMM サーバーを使用する場合に便利です。 この場合、プロジェクトコレクションのラボ資産をすべて削除し、ラボを再構成する必要があります。

注意

/Delete オプションは、コマンドラインで /libraryshare および /grouphost オプションが指定されていない場合にのみ、プロジェクトコレクション内のすべてのラボ資産に対して機能します。 詳細については、「 Tfsconfig lab/libraryshare コマンド 」および「 tfsconfig lab/hostgroup コマンド」を参照してください。

次の例では、DefaultCollection プロジェクトコレクション内のすべてのラボオブジェクトが削除されます。 /External オプションが指定されていないため、オブジェクトは SCVMM に保持されます。

tfsconfig lab /delete /collectionName:DefaultCollection

TfsConfig Lab/delete オプションを使用して、指定したプロジェクトコレクションからすべてのグループホスト、ライブラリ共有、および環境を削除します。 既定では、System Center Virtual Machine Manager (SCVMM) に関連付けられているオブジェクトは削除されません。 コマンドラインに /External オプションを追加すると、プロジェクトコレクションと SCVMM からオブジェクトを削除できます。

TfsConfig Lab /Delete /CollectionName:collectionName [/External] [/NoPrompt]
オプション 説明
CollectionName: CollectionName 必須です。 Azure DevOps Server のアプリケーション層のプロジェクトコレクションの名前を指定します。
外部 省略可能。 指定すると、プロジェクトコレクション内のオブジェクトに加えて、SCVMM 内のライブラリ共有とホストグループが削除されます。 /External が指定されていない場合、 TfsConfig Lab/delete コマンドはプロジェクトコレクション内のオブジェクトのみを削除します。
NoPrompt 省略可能。 指定した場合、進行状況および成功の情報は表示されません。

注釈

プロジェクトコレクションのラボ構成をデタッチする場合は、 /delete コマンドを使用して、プロジェクトコレクションからラボアセットを削除します。 これは、ある Azure DevOps Server インスタンスから別のインスタンスにプロジェクトコレクションを移動する場合や、新しい Azure DevOps Server インスタンスが元のものとは異なる SCVMM サーバーを使用する場合に便利です。 この場合、プロジェクトコレクションのラボ資産をすべて削除し、ラボを再構成する必要があります。

注意

/Delete オプションは、コマンドラインで /libraryshare および /grouphost オプションが指定されていない場合にのみ、プロジェクトコレクション内のすべてのラボ資産に対して機能します。 詳細については、「 TFSConfig Lab/libraryshare コマンド(.」を参照してください。/tfsconfig-md # lab-libraryshare) と Tfsconfig lab/hostgroup コマンド

次の例では、DefaultCollection プロジェクトコレクション内のすべてのラボオブジェクトが削除されます。 /External オプションが指定されていないため、オブジェクトは SCVMM に保持されます。

tfsconfig lab /delete /collectionName:DefaultCollection

ラボ/dns

TfsConfig Lab/dns コマンドは、ネットワーク分離環境用に Visual Studio Lab Management によって作成された dns レコードを追加、削除、または表示します。

    TfsConfig Lab /DNS 
    {/Add | /Delete | /List}
        [/CollectionName:collectionName |
        / CollectionName:collectionName /TeamProject:projectName |
        / CollectionName:collectionName /TeamProject:projectName /LabEnvironment:environmentUri |
        /Name:FQDN /IP:IpAddress]
        [/NoPrompt]
オプション 説明
追加 指定された DNS レコードを追加します。 /Add オプションを使用するには、対象の環境が実行されている必要があります。
削除 指定された DNS レコードを削除します。
リスト 指定された DNS レコードを表示します。
Labenvironment: 環境 uri では、 /add/delete、または /List オプションが、環境 uri で指定された個々のネットワーク分離環境に対してターゲットになります。

Labenvironment オプションを使用するには、 /Collection オプションと /TeamProject オプションも指定する必要があります。
TeamProject: projectName /Labenvironment を指定せずに使用した場合、は、projectName によって指定されたプロジェクト内のすべてのネットワーク分離環境に対して、 /add/delete、または /list オプションを対象とします。 それ以外の場合、 /TeamProject は環境を含むプロジェクトを指定します。

/TeamProject オプションを使用するには、 /collection オプションも指定する必要があります。
CollectionName: CollectionName /TeamProject を指定せずに使用した場合、collectionName によって指定されたプロジェクトコレクション内のすべてのネットワーク分離環境に対して、 /add/delete、または /list オプションが対象となります。 それ以外の場合、 /collection は、プロジェクトを含むプロジェクトコレクションを指定します。
名前: ここに 対象となる環境を含むネットワーク上の場所の完全修飾ドメイン名を指定します。

/Name オプションと /IP オプションを一緒に指定する必要があります。
IP: IPAddress 対象となる環境の IP アドレスを指定します。

/Name オプションと /IP オプションを一緒に指定する必要があります。

注釈

Azure DevOps Server では、ネットワーク分離環境内の各仮想マシンの DNS に一意の外部名を登録するときに入力したサフィックスが使用されます。 DNS エイリアス レコードを使用すると、コンピューターおよび分離ネットワーク外のその他のオブジェクトが分離ネットワーク内でコンピューターと通信できるようになります。 Azure DevOps Server は、DNS ゾーンに移動してエイリアスレコードを登録するため、Azure DevOps を実行するサービスアカウントには、指定された DNS ゾーンのエイリアスレコードを追加または削除するためのアクセス許可が必要です。

Team Foundation Server の配置に複数のアプリケーション層があり、各アプリケーション層が別のサービス アカウントで実行している場合、各アプリケーション層のサービス アカウントは、他のアプリケーション層で作成された DNS エイリアス レコードを編集するためのアクセス許可が必要です。

注意

DNS レコードの管理は、Lab Management によって自動的に実行されます。 /Dns コマンドは、次の状況でのみ使用してください。

  • Azure DevOps Server の実行に使用するアカウントを変更します。
  • Azure DevOps Server の1つのインスタンスから別のインスタンスにプロジェクトコレクションを移動します。

どちらの場合も、古い Azure DevOps Server サービスアカウントを使用して作成された DNS レコードを削除する必要があります。その後、新しい Azure DevOps Server サービスアカウントを使用して、同じ DNS レコードを再作成する必要があります。 前のシナリオでこれらの手順が実行されていない場合、新しい Azure DevOps Server サービスアカウントは、これらの DNS レコードの自動管理を実行できません。 その結果、ユーザーは仮想環境に接続できなくなります。

TfsConfig Lab/dns コマンドラインで、 /add/delete、または /list オプションのいずれか1つだけを指定してください。 ターゲットオプションを指定しない場合、操作は、Team Foundation Server データベース内のすべてのプロジェクトコレクションに属するすべてのネットワーク分離環境のすべての仮想マシンに対して動作します。

Lab Management オブジェクト階層内のオブジェクトのネットワーク分離環境の DNS エントリをターゲットにするには、 /collection/TeamProject、および /labenvironment オプションの適切な組み合わせを使用します。

  • /Labenvironment オプションは、指定されたネットワーク分離環境に対してコマンドを実行します。 /CollectionName オプションと /TeamProject オプションを使用して、その環境を含むプロジェクトコレクションとプロジェクトを指定する必要があります。

    環境の URI を指定するには、 Vstfs:///LabManagement/LabEnvironment/ environmentID の形式を使用します。 環境 id (environmnetID) は、Lab Management の環境ビューアー、または SCVMM 管理コンソールの仮想マシンの説明から表示できます。

  • /TeamProject オプションは、指定したプロジェクト内の分離されたネットワーク環境に対する操作を対象とします。 /TeamProject オプションは /CollectionName オプションと共に使用する必要があります。 /CollectionName オプションでは、プロジェクトを含むプロジェクトコレクションを指定する必要があります。

  • /CollectionName オプションは、指定されたプロジェクトコレクション内のネットワーク分離環境に対する操作を対象とします。

ネットワーク分離環境を対象とする2番目の方法は、 /name オプションと /IP オプションを使用して、個々の仮想マシンの完全修飾外部名と外部 IP アドレスを指定する方法です。 コマンドラインで、 /name オプションと /IP オプションの両方を指定する必要があります。 仮想マシンの外部名と外部 IP アドレスを表示するには、Lab Management の環境ビューアーまたは SCVMM 管理コンソールの仮想マシンの説明を参照してください。

最初の例では、プロジェクト内のすべてのネットワーク分離環境のレコードが DNS に追加されます。 2番目の例では、個々の DNS レコードが削除されます。

tfsconfig lab /dns /add /collectionname:Collection0 /teamproject:Project1
tfsconfig lab /dns /delete /name:0b668996-2736-46d2-88ac-0733acbd0d9c.contoso.com /ip:111.00.000.000

TfsConfig Lab/dns コマンドは、ネットワーク分離環境用に Visual Studio Lab Management によって作成された dns レコードを追加、削除、または表示します。

TfsConfig Lab /DNS 
{/Add | /Delete | /List}
    [/CollectionName:collectionName |
    / CollectionName:collectionName /TeamProject:projectName |
    / CollectionName:collectionName /TeamProject:projectName /LabEnvironment:environmentUri |
    /Name:FQDN /IP:IpAddress]
    [/NoPrompt]
オプション 説明
追加 指定された DNS レコードを追加します。 /Add オプションを使用するには、対象の環境が実行されている必要があります。
削除 指定された DNS レコードを削除します。
リスト 指定された DNS レコードを表示します。
Labenvironment: 環境 uri では、 /add/delete、または /List オプションが、環境 uri で指定された個々のネットワーク分離環境に対してターゲットになります。

Labenvironment オプションを使用するには、 /Collection オプションと /TeamProject オプションも指定する必要があります。
TeamProject: projectName /Labenvironment を指定せずに使用した場合、は、projectName によって指定されたプロジェクト内のすべてのネットワーク分離環境に対して、 /add/delete、または /list オプションを対象とします。 それ以外の場合、 /TeamProject は環境を含むプロジェクトを指定します。

/TeamProject オプションを使用するには、 /collection オプションも指定する必要があります。
CollectionName: CollectionName /TeamProject を指定せずに使用した場合、collectionName によって指定されたプロジェクトコレクション内のすべてのネットワーク分離環境に対して、 /add/delete、または /list オプションが対象となります。 それ以外の場合、 /collection は、プロジェクトを含むプロジェクトコレクションを指定します。
名前: ここに 対象となる環境を含むネットワーク上の場所の完全修飾ドメイン名を指定します。

/Name オプションと /IP オプションを一緒に指定する必要があります。
IP: IPAddress 対象となる環境の IP アドレスを指定します。

/Name オプションと /IP オプションを一緒に指定する必要があります。

注釈

Azure DevOps Server では、ネットワーク分離環境内の各仮想マシンの DNS に一意の外部名を登録するときに入力したサフィックスが使用されます。 DNS エイリアス レコードを使用すると、コンピューターおよび分離ネットワーク外のその他のオブジェクトが分離ネットワーク内でコンピューターと通信できるようになります。 Azure DevOps Server は、DNS ゾーンに移動してエイリアスレコードを登録するため、Azure DevOps を実行するサービスアカウントには、指定された DNS ゾーンのエイリアスレコードを追加または削除するためのアクセス許可が必要です。

Azure DevOps Server 配置に複数のアプリケーション層があり、各アプリケーション層が異なるサービスアカウントで実行されている場合は、各アプリケーション層サービスアカウントに、他のアプリケーション層によって作成された DNS エイリアスレコードを編集するためのアクセス許可が必要です。

注意

DNS レコードの管理は、Lab Management によって自動的に実行されます。 /Dns コマンドは、次の状況でのみ使用してください。

  • Azure DevOps Server の実行に使用するアカウントを変更します。
  • Azure DevOps Server の1つのインスタンスから別のインスタンスにプロジェクトコレクションを移動します。

どちらの場合も、古い Azure DevOps Server サービスアカウントを使用して作成された DNS レコードを削除する必要があります。その後、新しい Azure DevOps Server サービスアカウントを使用して、同じ DNS レコードを再作成する必要があります。 前のシナリオでこれらの手順が実行されていない場合、新しい Azure DevOps Server サービスアカウントは、これらの DNS レコードの自動管理を実行できません。 その結果、ユーザーは仮想環境に接続できなくなります。

TfsConfig Lab/dns コマンドラインで、 /add/delete、または /list オプションのいずれか1つだけを指定してください。 ターゲットオプションを指定しない場合、操作は、Azure DevOps Server データベース内のすべてのプロジェクトコレクションに属するすべてのネットワーク分離環境のすべての仮想マシンに対して動作します。

Lab Management オブジェクト階層内のオブジェクトのネットワーク分離環境の DNS エントリをターゲットにするには、 /collection/TeamProject、および /labenvironment オプションの適切な組み合わせを使用します。

  • /Labenvironment オプションは、指定されたネットワーク分離環境に対してコマンドを実行します。 /CollectionName オプションと /TeamProject オプションを使用して、その環境を含むプロジェクトコレクションとプロジェクトを指定する必要があります。

    環境の URI を指定するには、 Vstfs:///LabManagement/LabEnvironment/ environmentID の形式を使用します。 環境 id (environmnetID) は、Lab Management の環境ビューアー、または SCVMM 管理コンソールの仮想マシンの説明から表示できます。

  • /TeamProject オプションは、指定したプロジェクト内の分離されたネットワーク環境に対する操作を対象とします。 /TeamProject オプションは /CollectionName オプションと共に使用する必要があります。 /CollectionName オプションでは、プロジェクトを含むプロジェクトコレクションを指定する必要があります。

  • /CollectionName オプションは、指定されたプロジェクトコレクション内のネットワーク分離環境に対する操作を対象とします。

ネットワーク分離環境を対象とする2番目の方法は、 /name オプションと /IP オプションを使用して、個々の仮想マシンの完全修飾外部名と外部 IP アドレスを指定する方法です。 コマンドラインで、 /name オプションと /IP オプションの両方を指定する必要があります。 仮想マシンの外部名と外部 IP アドレスを表示するには、Lab Management の環境ビューアーまたは SCVMM 管理コンソールの仮想マシンの説明を参照してください。

最初の例では、プロジェクト内のすべてのネットワーク分離環境のレコードが DNS に追加されます。 2番目の例では、個々の DNS レコードが削除されます。

REM First example
tfsconfig lab /dns /add /collectionname:Collection0 /teamproject:Project1

REM Second example
tfsconfig lab /dns /delete /name:0b668996-2736-46d2-88ac-0733acbd0d9c.contoso.com /ip:111.00.000.000

ラボ/ホストグループ

TfsConfig Lab/hostgroup コマンドを使用して、プロジェクトコレクションへの SYSTEM CENTER VIRTUAL MACHINE MANAGER (SCVMM) ホストグループの割り当てを追加、編集、または削除します。 この方法で割り当てられたホストグループは、Visual Studio Lab Management によって管理されます。

TfsConfig Lab /hostgroup /CollectionName:collectionName
      { /Add 
            /SCVMMHostGroup:vmmHostPath 
            /Name:name 
            [LabEnvironmentPlacementPolicy:{Conservative|Aggressive}]
            [/AutoProvision:{True|False}]
            [/DNSSuffix:dnsSuffix]
       | /Delete 
            /Name:name
            [/NoPrompt]
       | /Edit 
            /Name:name
            {[/AutoProvision:{True|False}] 
            [/LabEnvironmentPlacementPolicy:{Conservative|Aggressive}] 
            [/DNSSuffix:dnsSuffix]}
            [/NoPrompt]]
       | /List
       | /ListSCVmmHostGroups }

オプション

説明

CollectionName: CollectionName

必須です。 アプリケーション層 Azure DevOps Server のプロジェクトコレクションの名前。

追加

指定された SCVMM ホストグループをプロジェクトコレクションホストグループに追加します。 Addを使用して、 /SCVmmHostGroupオプションと/nameオプションを指定する必要があります。

削除

指定したホストグループをプロジェクトコレクションから削除します。 /NameオプションはDeleteと共に指定する必要があります。

編集

ホストグループの Lab Management Autoprovisionlab環境 の両方のポリシープロパティの一方または両方を設定します。

/Nameオプションを指定し、少なくとも1つの/autoプロビジョンまたは/lab環境の使用ポリシーオプションを編集して指定する必要があります。

SCVMMHostGroup: vmmH ostgrouppath

/Addオプションを指定する必要があります。 SCVMM ホスト グループのホストのパスを指定します。

名前: 名前

/Add/delete、または/Editオプションを指定する必要があります。 追加、削除、または編集するプロジェクトコレクションホストグループの名前を指定します。

Autoprovision:{True | False}

/Addオプションまたは/Editオプションを指定した場合は省略可能です。 ホストグループの AutoProvision プロパティを設定 (True) またはクリア (False) します。 Autoprovision は、ホストグループがコレクション内の各プロジェクトに自動的に割り当てられるかどうかを指定します。 既定では、 TfsConfig Lab/HostGroup コマンドを使用すると、ホストグループはコレクション内のプロジェクトに割り当てられます。

Lab環境のための ementpolicy:{控えめな | アグレッシブ}

/Addオプションまたは/Editオプションを指定した場合は省略可能です。 新しいバーチャルラボ環境を展開するホストグループ内の物理マシンを Lab Management がどのように扱うかを指定します。

  • 控えめ (既定値)。 配置を決定する際に、実行されていない仮想環境を考慮します。 これには、停止状態の環境に含まれるすべての仮想マシンが含まれ " " ます。

  • アグレッシブ デプロイの決定で、実行されていない仮想環境を考慮しないでください。

DNSSuffix:[DNSSuffix]

省略可能。 ホストグループ内の仮想コンピューターの DNS サフィックスを設定します。

  • DnsSuffix 値を指定せずに /DNSSuffix: オプションを指定した場合、は、仮想コンピューターのサフィックスの DNS サフィックスを、ホストグループ内のホストコンピューターのサフィックスに設定またはリセットします。

  • /DNSSuffixオプションが/addオプションと共に指定されていない場合、仮想コンピューターのサフィックスは、ホストグループ内のホストコンピューターのサフィックスに設定されます。

  • /DNSSuffixオプションが/Editオプションで指定されていない場合、仮想コンピューターのサフィックスは変更されません。

NoPrompt

オプションで、 /delete オプションまたは /Edit オプションを指定します。 ユーザーに確認のプロンプトが表示されません。

リスト

プロジェクトコレクションに割り当てられているホストグループを表示します。

ListSCVmmHostGroups

SCVMM から使用できるホスト グループが表示されます。

注釈

ホスト グループは、一連の仮想マシン ホストをグループ化して管理しやすくするために、管理者が SCVMM 内に作成するコンテナーです。 ホスト グループは階層構造を持ち、1 つのホスト グループに他の複数のホスト グループを含めることができます。

各ホスト グループは、ホスト パス (SCVMM のホスト グループの階層内におけるホストまたはホスト グループの場所を示す、ホスト グループ名のシーケンス) によって識別されます。 すべてのホスト パスは、ルートのホスト グループで始まります。 たとえば、ホストパスは、ホスト VMHost05 がホストグループ All Hosts\\New York\\Site21\\VMHost05 Site21 に属していることを示しています。これは、ホストグループニューヨークの子ホストグループです。

コマンドラインでは、 /add/delete、または /Edit のいずれかのオプションのみを使用します。 個別の TfsConfig Lab/hostgroup コマンドラインを使用して、プロジェクトコレクションに複数のホストグループを割り当てます。

また、 TfsConfig Lab/hostgroup コマンドを使用して、Lab Management に固有のプロパティを設定することもできます。

  • AutoProvision は、ホストグループがプロジェクトコレクション内の各プロジェクトに割り当てられるかどうかを指定します。 既定では、AutoProvision はオンです。 プロジェクトコレクション内のホストグループを個々のプロジェクトに割り当てるには、 TFSLabConfig Createteam コマンドを使用します。

    • True (既定値)。 ホストグループは、プロジェクトコレクション内の各プロジェクトに割り当てられます。

    • [False] 。 ホストグループは、プロジェクトコレクション内の各プロジェクトに割り当てられていません。

  • Labenvironment 配置 Ementpolicy は、ホストグループ内の物理マシンに新しい環境を展開するときに、Lab Management が既存の仮想マシンを考慮するかどうかを指定します。

    • 控えめ (既定値)。 配置を決定する際に、実行されていない仮想環境を考慮します。 これには、環境の一部であり、"停止" 状態である仮想マシンもすべて含まれます。

    • アグレッシブ デプロイの決定で、実行されていない仮想環境を考慮しないでください。

  • DNSSuffix は、ホストグループで作成された仮想コンピューターに使用する DNS サフィックスを指定します。 次の表に、/DNSSuffix の設定によって仮想コンピューターの DNS サフィックスがどのような影響を受けるかを示します。

DNSSuffix /Add /Edit
DNSSuffix: dnsvalue DNS サフィックスは dnsValue に設定されています。 DNS サフィックスは dnsValue に設定されています。
DNSSuffix DNS サフィックスはホスト コンピューターから継承されます。 既存のサフィックスの値が削除され、DNS サフィックスはホスト コンピューターから継承されます。
<指定なし> DNS サフィックスはホスト コンピューターから継承されます。 DNS サフィックスは変更されません。

次の例では、SCVMM ホストグループがプロジェクトコレクションに割り当てられています。 /Autoプロビジョニング オプションが指定されていないため、ホストグループはコレクション内のすべてのプロジェクトに自動的に割り当てられます。

tfsconfig lab /hostgroup /add /scvmmhostgroup:"All Hosts\Lab1\HostGroup1" /collection:Collection0
        /name:Lab1Collection0_Lab1_HostGroup1

TfsConfig Lab/hostgroup コマンドを使用して、プロジェクトコレクションへの SYSTEM CENTER VIRTUAL MACHINE MANAGER (SCVMM) ホストグループの割り当てを追加、編集、または削除します。 この方法で割り当てられたホストグループは、Visual Studio Lab Management によって管理されます。

TfsConfig Lab /hostgroup /CollectionName:collectionName
  { /Add 
        /SCVMMHostGroup:vmmHostPath 
        /Name:name 
        [LabEnvironmentPlacementPolicy:{Conservative|Aggressive}]
        [/AutoProvision:{True|False}]
        [/DNSSuffix:dnsSuffix]
   | /Delete 
        /Name:name
        [/NoPrompt]
   | /Edit 
        /Name:name
        {[/AutoProvision:{True|False}] 
        [/LabEnvironmentPlacementPolicy:{Conservative|Aggressive}] 
        [/DNSSuffix:dnsSuffix]}
        [/NoPrompt]]
   | /List
   | /ListSCVmmHostGroups }

オプション

説明

CollectionName: CollectionName

必須です。 アプリケーション層 Azure DevOps Server のプロジェクトコレクションの名前。

追加

指定された SCVMM ホストグループをプロジェクトコレクションホストグループに追加します。 Addを使用して、 /SCVmmHostGroupオプションと/nameオプションを指定する必要があります。

削除

指定したホストグループをプロジェクトコレクションから削除します。 /NameオプションはDeleteと共に指定する必要があります。

編集

ホストグループの Lab Management Autoprovisionlab環境 の両方のポリシープロパティの一方または両方を設定します。

/Nameオプションを指定し、少なくとも1つの/autoプロビジョンまたは/lab環境の使用ポリシーオプションを編集して指定する必要があります。

SCVMMHostGroup: vmmH ostgrouppath

/Addオプションを指定する必要があります。 SCVMM ホスト グループのホストのパスを指定します。

名前: 名前

/Add/delete、または/Editオプションを指定する必要があります。 追加、削除、または編集するプロジェクトコレクションホストグループの名前を指定します。

Autoprovision:{True | False}

/Addオプションまたは/Editオプションを指定した場合は省略可能です。 ホストグループの AutoProvision プロパティを設定 (True) またはクリア (False) します。 Autoprovision は、ホストグループがコレクション内の各プロジェクトに自動的に割り当てられるかどうかを指定します。 既定では、 TfsConfig Lab/HostGroup コマンドを使用すると、ホストグループはコレクション内のプロジェクトに割り当てられます。

Lab環境のための ementpolicy:{控えめな | アグレッシブ}

/Addオプションまたは/Editオプションを指定した場合は省略可能です。 新しいバーチャルラボ環境を展開するホストグループ内の物理マシンを Lab Management がどのように扱うかを指定します。

  • 控えめ (既定値)。 配置を決定する際に、実行されていない仮想環境を考慮します。 これには、停止状態の環境に含まれるすべての仮想マシンが含まれ " " ます。

  • アグレッシブ デプロイの決定で、実行されていない仮想環境を考慮しないでください。

DNSSuffix:[DNSSuffix]

省略可能。 ホストグループ内の仮想コンピューターの DNS サフィックスを設定します。

  • DnsSuffix 値を指定せずに /DNSSuffix: オプションを指定した場合、は、仮想コンピューターのサフィックスの DNS サフィックスを、ホストグループ内のホストコンピューターのサフィックスに設定またはリセットします。

  • /DNSSuffixオプションが/addオプションと共に指定されていない場合、仮想コンピューターのサフィックスは、ホストグループ内のホストコンピューターのサフィックスに設定されます。

  • /DNSSuffixオプションが/Editオプションで指定されていない場合、仮想コンピューターのサフィックスは変更されません。

NoPrompt

オプションで、 /delete オプションまたは /Edit オプションを指定します。 ユーザーに確認のプロンプトが表示されません。

リスト

プロジェクトコレクションに割り当てられているホストグループを表示します。

ListSCVmmHostGroups

SCVMM から使用できるホスト グループが表示されます。

注釈

ホスト グループは、一連の仮想マシン ホストをグループ化して管理しやすくするために、管理者が SCVMM 内に作成するコンテナーです。 ホスト グループは階層構造を持ち、1 つのホスト グループに他の複数のホスト グループを含めることができます。

各ホスト グループは、ホスト パス (SCVMM のホスト グループの階層内におけるホストまたはホスト グループの場所を示す、ホスト グループ名のシーケンス) によって識別されます。 すべてのホスト パスは、ルートのホスト グループで始まります。 たとえば、ホストパスは、ホスト VMHost05 がホストグループ All Hosts\\New York\\Site21\\VMHost05 Site21 に属していることを示しています。これは、ホストグループニューヨークの子ホストグループです。

コマンドラインでは、 /add/delete、または /Edit のいずれかのオプションのみを使用します。 個別の TfsConfig Lab/hostgroup コマンドラインを使用して、プロジェクトコレクションに複数のホストグループを割り当てます。

また、 TfsConfig Lab/hostgroup コマンドを使用して、Lab Management に固有のプロパティを設定することもできます。

  • AutoProvision は、ホストグループがプロジェクトコレクション内の各プロジェクトに割り当てられるかどうかを指定します。 既定では、AutoProvision はオンです。 プロジェクトコレクション内のホストグループを個々のプロジェクトに割り当てるには、 TFSLabConfig Createteam コマンドを使用します。

    • True (既定値)。 ホストグループは、プロジェクトコレクション内の各プロジェクトに割り当てられます。

    • [False] 。 ホストグループは、プロジェクトコレクション内の各プロジェクトに割り当てられていません。

  • Labenvironment 配置 Ementpolicy は、ホストグループ内の物理マシンに新しい環境を展開するときに、Lab Management が既存の仮想マシンを考慮するかどうかを指定します。

    • 控えめ (既定値)。 配置を決定する際に、実行されていない仮想環境を考慮します。 これには、環境の一部であり、"停止" 状態である仮想マシンもすべて含まれます。

    • アグレッシブ デプロイの決定で、実行されていない仮想環境を考慮しないでください。

  • DNSSuffix は、ホストグループで作成された仮想コンピューターに使用する DNS サフィックスを指定します。 次の表に、/DNSSuffix の設定によって仮想コンピューターの DNS サフィックスがどのような影響を受けるかを示します。

DNSSuffix /Add /Edit
DNSSuffix: dnsvalue DNS サフィックスは dnsValue に設定されています。 DNS サフィックスは dnsValue に設定されています。
DNSSuffix DNS サフィックスはホスト コンピューターから継承されます。 既存のサフィックスの値が削除され、DNS サフィックスはホスト コンピューターから継承されます。
<指定なし> DNS サフィックスはホスト コンピューターから継承されます。 DNS サフィックスは変更されません。

次の例では、SCVMM ホストグループがプロジェクトコレクションに割り当てられています。 /Autoプロビジョニング オプションが指定されていないため、ホストグループはコレクション内のすべてのプロジェクトに自動的に割り当てられます。

tfsconfig lab /hostgroup /add /scvmmhostgroup:"All Hosts\Lab1\HostGroup1" /collection:Collection0
            /name:Lab1Collection0_Lab1_HostGroup1

ラボ/ライブラリ共有

TfsConfig Lab/libraryshare コマンドを使用して、SYSTEM CENTER VIRTUAL MACHINE MANAGER (SCVMM) からプロジェクトコレクションへのライブラリ共有の割り当てを追加、削除、または編集することができます。 このコマンドを使用して、Visual Studio Lab Management に固有のプロパティを設定したり、Lab Management のコレクションに現在割り当てられているライブラリ共有を表示したり、SCVMM 内のすべてのライブラリ共有を表示したりすることもできます。

TfsConfig Lab /LibraryShare
    /CollectionName:collectionName
     { /Add 
       /SCVMMLibraryShare:librarySharePath 
       /Name:name 
        [/AutoProvision:{True|False}]
    | /Delete 
       /Name:name 
        [/NoPrompt]
    | /Edit 
       /Name:name 
       /AutoProvision:{True|False} 
        [/NoPrompt]
    | /List
    | /ListSCVMMLibraryShares }
オプション 説明
追加 指定したライブラリ共有をプロジェクトコレクションに追加します。 Add を使用して、 /SCVMMLibraryShare オプションと /name オプションを指定する必要があります。
削除 指定したライブラリ共有をプロジェクトコレクションから削除します。 /Name オプションは Delete と共に指定する必要があります。
編集 ライブラリ共有の AutoProvision プロパティを設定または解除します。 /Name オプションと /autoプロビジョン オプションは、 Edit を指定して指定する必要があります。

既定では、ライブラリ共有はコレクション内のプロジェクトに割り当てられます。

自動プロビジョンを変更すると、既存のプロジェクトに影響します。
CollectionName: CollectionName 必須です。 アプリケーション層 Azure DevOps Server でプロジェクトコレクションの名前を指定します。
SCVMMLibraryShare: librarysharePath Add を使用する必要があります。 Virtual Machine Manager ライブラリ共有へのパスを指定します。
名前: librarysharename 追加削除、および 編集 に必要です。 プロジェクトコレクション内のライブラリ共有の名前を指定します。
AutoProvision Add の場合は省略可能。編集 で必要です。 ライブラリ共有をコレクション内の各プロジェクトに自動的に割り当てるかどうかを指定します。 既定では、ライブラリ共有はプロジェクトに割り当てられます。
NoPrompt 追加編集 で省略可能。 ユーザーに確認のプロンプトが表示されません。
リスト 指定されたプロジェクトコレクションに割り当てられているすべてのライブラリ共有を一覧表示します。
ListSCVMMLibraryShares Virtual Machine Manager で使用できるすべてのライブラリ共有を一覧表示します。

注釈

ライブラリ共有は、Virtual Machine Manager ライブラリサーバー上の指定された共有です。 ライブラリ共有は、ISO イメージや仮想ハードディスクなど、ライブラリサーバーに格納されている仮想 Lab Management 環境のファイルベースのリソースへのアクセスを提供します。 ライブラリ共有は Virtual Machine Manager で作成されます。 Visual Studio Lab Management は、ライブラリ共有を使用してラボに仮想マシンをプロビジョニングします。

TfsConfig Lab/libraryshare コマンドラインでは、 /add/Edit、または /delete オプションのいずれか1つのみを使用します。 個別の TfsConfig Lab/libraryshare コマンドラインを使用して、複数のライブラリ共有をコレクションに割り当てます。

既定では、プロジェクトコレクション内のライブラリ共有は、コレクション内の各プロジェクトに自動的に割り当てられます。 /Autoプロビジョン オプションを /add および /Edit コマンドと共に使用して、ライブラリ共有が割り当てられるように変更できます。

  • /Autoプロビジョン オプションを False に設定すると、ライブラリ共有のプロジェクトへの自動割り当てが無効になります。 個々のプロジェクトのライブラリ共有を割り当てたり、削除したりするには、 TfsLabConfig TfsLabConfig CreateTeamProjectLibraryShare コマンドを使用します。

  • 自動割り当てを有効にするには、 /autoプロビジョン オプションを True に設定します。

TfsConfig Lab/libraryshare コマンドを使用して、SYSTEM CENTER VIRTUAL MACHINE MANAGER (SCVMM) からプロジェクトコレクションへのライブラリ共有の割り当てを追加、削除、または編集することができます。 このコマンドを使用して、Visual Studio Lab Management に固有のプロパティを設定したり、Lab Management のコレクションに現在割り当てられているライブラリ共有を表示したり、SCVMM 内のすべてのライブラリ共有を表示したりすることもできます。

TfsConfig Lab /LibraryShare
        /CollectionName:collectionName
        { /Add
            /SCVMMLibraryShare:librarySharePath
            /Name:name
            [/AutoProvision:{True|False}]
        | /Delete
            /Name:name
            [/NoPrompt]
        | /Edit
            /Name:name
            /AutoProvision:{True|False}
            [/NoPrompt]
        | /List
        | /ListSCVMMLibraryShares }
オプション 説明
追加 指定したライブラリ共有をプロジェクトコレクションに追加します。 Add を使用して、 /SCVMMLibraryShare オプションと /name オプションを指定する必要があります。
削除 指定したライブラリ共有をプロジェクトコレクションから削除します。 /Name オプションは Delete と共に指定する必要があります。
編集 ライブラリ共有の AutoProvision プロパティを設定または解除します。 /Name オプションと /autoプロビジョン オプションは、 Edit を指定して指定する必要があります。

既定では、ライブラリ共有はコレクション内のプロジェクトに割り当てられます。

[!NOTE] 自動プロビジョンを変更すると、既存のプロジェクトに影響します。
CollectionName: CollectionName 必須です。 アプリケーション層 Azure DevOps Server でプロジェクトコレクションの名前を指定します。
SCVMMLibraryShare: librarysharePath Add を使用する必要があります。 Virtual Machine Manager ライブラリ共有へのパスを指定します。
名前: librarysharename 追加削除、および 編集 に必要です。 プロジェクトコレクション内のライブラリ共有の名前を指定します。
AutoProvision Add の場合は省略可能。編集 で必要です。 ライブラリ共有をコレクション内の各プロジェクトに自動的に割り当てるかどうかを指定します。 既定では、ライブラリ共有はプロジェクトに割り当てられます。
NoPrompt 追加編集 で省略可能。 ユーザーに確認のプロンプトが表示されません。
リスト 指定されたプロジェクトコレクションに割り当てられているすべてのライブラリ共有を一覧表示します。
ListSCVMMLibraryShares Virtual Machine Manager で使用できるすべてのライブラリ共有を一覧表示します。

注釈

ライブラリ共有は、Virtual Machine Manager ライブラリサーバー上の指定された共有です。 ライブラリ共有は、ISO イメージや仮想ハードディスクなど、ライブラリサーバーに格納されている仮想 Lab Management 環境のファイルベースのリソースへのアクセスを提供します。 ライブラリ共有は Virtual Machine Manager で作成されます。 Visual Studio Lab Management は、ライブラリ共有を使用してラボに仮想マシンをプロビジョニングします。

TfsConfig Lab/libraryshare コマンドラインでは、 /add/Edit、または /delete オプションのいずれか1つのみを使用します。 個別の TfsConfig Lab/libraryshare コマンドラインを使用して、複数のライブラリ共有をコレクションに割り当てます。

既定では、プロジェクトコレクション内のライブラリ共有は、コレクション内の各プロジェクトに自動的に割り当てられます。 /Autoプロビジョン オプションを /add および /Edit コマンドと共に使用して、ライブラリ共有が割り当てられるように変更できます。

  • /Autoプロビジョン オプションを False に設定すると、ライブラリ共有のプロジェクトへの自動割り当てが無効になります。 個々のプロジェクトのライブラリ共有を割り当てたり、削除したりするには、 TfsLabConfig TfsLabConfig CreateTeamProjectLibraryShare コマンドを使用します。

  • 自動割り当てを有効にするには、 /autoプロビジョン オプションを True に設定します。


ラボの/settings

TFSConfig Lab/settings オプションを使用して、Visual Studio Lab Management を構成できます。 設定オプション

  • ラボにおける仮想マシンの管理を制御する System Center Virtual Machine Manager (SCVMM) サーバーの名前を設定します。

  • すべてのホスト グループ 内の物理コンピューターが接続できるネットワーク場所 (ネットワーク ドメインやワークグループなど) を設定します。

  • ラボにおけるネットワーク分離ネットワークのための IP アドレスおよび仮想 DNS サフィックスを設定します。

TfsConfig Lab
    /Settings
        [/ScVmmServerName:VMMServerName]
        [/NetworkLocation:networkLocation]
        [/IpBlock:networkIsolationIpRange]
        [/DnsSuffix:networkIsolationDnsSuffix] 
        [/NoPrompt]
        [/List]
オプション 説明
ScvmmServerName: 省略可能。 Azure DevOps Server によって使用される System Center Virtual Machine Manager 2008 (SCVMM) サーバーの完全修飾名を設定します。 これは、仮想マシンを管理するために使用される SCVMM サーバーの名前です。 Azure DevOps Server が SCVMM と通信するには、Azure DevOps Server が実行されているアカウントを SCVMM の管理者ロールに追加する必要があります。
Networklocation: networklocation 省略可能。 ラボ ネットワーク内のすべてのホストで使用できる、ネットワーク ドメインやワークグループなどのネットワークの完全修飾名を設定します。 仮想マシンをプロビジョニングすると、Lab Management によって仮想マシンが指定されたネットワークに自動的に接続されます。 SCVMM 管理者コンソールを使用して、ホスト上の使用可能なネットワークの場所を見つけることができます。
IpBlock: networkIsolationIpRange 省略可能。 分離ネットワークが作成されるときに環境内の仮想マシンに割り当てられる IP アドレスの範囲を設定します。 IP アドレスは仮想マシン間の内部ルーティングにのみ使用され、環境の境界を越えて公開されないため、 /networklocation オプションで指定されたネットワーク内で使用されていない任意の ip 範囲を指定できます。 ほとんどのケースで、既定の範囲である 192.168.23.0/24 で動作するはずです。 ネットワーク分離環境への接続で問題が生じる場合には、異なる範囲を選択する必要があるかもしれません。
DnsSuffix: networkIsolationDnsSuffix 省略可能。 仮想環境用の分離ネットワーク上の仮想マシンの名前を登録するために使用される DNS サフィックスを設定します。 DNS 階層内でサフィックスが適切に構成されていることを確認するため、ネットワーク管理者と連絡を取ってください。
NoPrompt 省略可能。 確認のダイアログを表示しません。 を /list オプションと共に使用しないでください。
リスト Lab Management の現在の構成値の一覧を表示します。

注釈

TfsConfig Lab の各コマンドラインで、 /ScvmmServerName/networklocation/IpBlock/DnsSuffix、または /list オプションのいずれかを指定する必要があります。

Lab Management を設定するには、 /ScVmmServerName オプションと /networklocation オプションの両方を指定する必要があります。 ただし、これらのオプションを別々のコマンド ラインに指定することができます。

ネットワークの分離を設定するには、 /IpBlock オプションと /DnsSuffix オプションの両方を指定する必要があります。 ただし、これらのオプションを別々のコマンド ラインに指定することができます。

ネットワーク分離により、コンピューター名や IP アドレスが競合することなく、仮想マシンの複数のコピーを使用することが可能になります。 DNS サフィックスと IP アドレス範囲の両方を分離ネットワークに割り当てる必要があります。 これらの IP アドレスは、仮想マシン間の内部ルーティングにのみ使用され、環境の境界外には公開されないので、パブリック ネットワークで使用されていない任意の IP 範囲を指定できます。 ほとんどのケースで、既定の範囲である192.168.1.0/24 で動作するはずです。 ネットワーク分離環境への接続で問題が生じる場合には、異なる範囲を選択する必要があるかもしれません。

この例では、1つのコマンドラインで /ScvmmServerName オプションと /networklocation オプションを使用して Lab Management を設定します。

tfsconfig lab /settings /scvmmservername:vmmserver /networklocation:lab1.contoso.com

この例では、個別のコマンドラインで /IpBlock オプションと /DNSSuffix オプションを使用して、ネットワーク分離を構成します。

tfsconfig lab /settings /ipblock: 192.168.23.0/24
tfsconfig lab /settings /dnssuffix:virtual1.lab1.contoso.com

TFSConfig Lab/settings オプションを使用して、Visual Studio Lab Management を構成できます。 設定オプション

  • ラボにおける仮想マシンの管理を制御する System Center Virtual Machine Manager (SCVMM) サーバーの名前を設定します。

  • すべてのホスト グループ 内の物理コンピューターが接続できるネットワーク場所 (ネットワーク ドメインやワークグループなど) を設定します。

  • ラボにおけるネットワーク分離ネットワークのための IP アドレスおよび仮想 DNS サフィックスを設定します。

    TfsConfig Lab/Settings [/ScVmmServerName: 名] [/networklocation: networkLocation] [/IpBlock: networkIsolationIpRange] [/DnsSuffix: networkIsolationDnsSuffix] [/NoPrompt] [/List]

オプション 説明
ScvmmServerName: 省略可能。 Azure DevOps Server によって使用される System Center Virtual Machine Manager 2008 (SCVMM) サーバーの完全修飾名を設定します。 これは、仮想マシンを管理するために使用される SCVMM サーバーの名前です。 Azure DevOps Server が SCVMM と通信するには、Azure DevOps Server が実行されているアカウントを SCVMM の管理者ロールに追加する必要があります。
Networklocation: networklocation 省略可能。 ラボ ネットワーク内のすべてのホストで使用できる、ネットワーク ドメインやワークグループなどのネットワークの完全修飾名を設定します。 仮想マシンをプロビジョニングすると、Lab Management によって仮想マシンが指定されたネットワークに自動的に接続されます。 SCVMM 管理者コンソールを使用して、ホスト上の使用可能なネットワークの場所を見つけることができます。
IpBlock: networkIsolationIpRange 省略可能。 分離ネットワークが作成されるときに環境内の仮想マシンに割り当てられる IP アドレスの範囲を設定します。 IP アドレスは仮想マシン間の内部ルーティングにのみ使用され、環境の境界を越えて公開されないため、 /networklocation オプションで指定されたネットワーク内で使用されていない任意の ip 範囲を指定できます。 ほとんどのケースで、既定の範囲である 192.168.23.0/24 で動作するはずです。 ネットワーク分離環境への接続で問題が生じる場合には、異なる範囲を選択する必要があるかもしれません。
DnsSuffix: networkIsolationDnsSuffix 省略可能。 仮想環境用の分離ネットワーク上の仮想マシンの名前を登録するために使用される DNS サフィックスを設定します。 DNS 階層内でサフィックスが適切に構成されていることを確認するため、ネットワーク管理者と連絡を取ってください。
NoPrompt 省略可能。 確認のダイアログを表示しません。 を /list オプションと共に使用しないでください。
リスト Lab Management の現在の構成値の一覧を表示します。

注釈

TfsConfig Lab の各コマンドラインで、 /ScvmmServerName/networklocation/IpBlock/DnsSuffix、または /list オプションのいずれかを指定する必要があります。

Lab Management を設定するには、 /ScVmmServerName オプションと /networklocation オプションの両方を指定する必要があります。 ただし、これらのオプションを別々のコマンド ラインに指定することができます。

ネットワークの分離を設定するには、 /IpBlock オプションと /DnsSuffix オプションの両方を指定する必要があります。 ただし、これらのオプションを別々のコマンド ラインに指定することができます。

ネットワーク分離により、コンピューター名や IP アドレスが競合することなく、仮想マシンの複数のコピーを使用することが可能になります。 DNS サフィックスと IP アドレス範囲の両方を分離ネットワークに割り当てる必要があります。 これらの IP アドレスは、仮想マシン間の内部ルーティングにのみ使用され、環境の境界外には公開されないので、パブリック ネットワークで使用されていない任意の IP 範囲を指定できます。 ほとんどのケースで、既定の範囲である192.168.1.0/24 で動作するはずです。 ネットワーク分離環境への接続で問題が生じる場合には、異なる範囲を選択する必要があるかもしれません。

この例では、1つのコマンドラインで /ScvmmServerName オプションと /networklocation オプションを使用して Lab Management を設定します。

tfsconfig lab /settings /scvmmservername:vmmserver /networklocation:lab1.contoso.com

この例では、個別のコマンドラインで /IpBlock オプションと /DNSSuffix オプションを使用して、ネットワーク分離を構成します。

tfsconfig lab /settings /ipblock: 192.168.23.0/24
tfsconfig lab /settings /dnssuffix:virtual1.lab1.contoso.com

OfflineDetach

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

TfsConfig offlineDetach /configurationDB:<databaseName>
    /collectionDB:<databaseName>
オプション 説明
configurationDB 使用する構成データベースの名前を指定します。
collectionDB デタッチするコレクションデータベースの名前を指定します。

前提条件

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

注釈

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

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

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

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

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

コマンドの可用性: TFS 2015 Update 3 以降

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

TFSConfig offlineDetach /configurationDB:DatabaseName
        /collectionDB:DatabaseName
オプション 説明
/configurationDB 使用する構成データベースの名前を指定します。
/collectionDB デタッチするコレクションデータベースの名前を指定します。

前提条件

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

注釈

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

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

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

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

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

プロキシ

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

Azure DevOps Proxy Server のインストールとプロキシの初期構成の詳細については、「 Azure DevOps プロキシサーバーをインストールしてリモートサイトをセットアップする方法 」を参照してください。 クライアントコンピューターでのプロキシの構成の詳細については、「 Azure DevOps バージョン管理のコマンドリファレンス」を参照してください。

TfsConfig proxy /add|delete|change [/Collection:<teamProjectCollectionURL> /account:<accountName>]
    /Server:<TeamFoundationServerURL> [/inputs:Key1=Value1; Key2=Value2;...] [/continue]
オプション 説明
add Proxy.config ファイルのプロキシ リストに指定されたサーバーまたはコレクションを追加します。 /add を複数回実行して、複数のコレクションまたはサーバーを含めることができます。 Azure DevOps Services でホストされているコレクションで/add を使用する場合は、Azure DevOps Services で資格情報の入力を求められます。
change (変更) Azure DevOps Services のサービスアカウントとして格納されている資格情報を変更します。 /Change オプションは Azure DevOps Services にのみ使用されます。Azure DevOps Server のローカル配置には使用しないでください。
delete Proxy.config ファイルのプロキシ リストから指定されたサーバーまたはコレクションを削除します。
account Azure DevOps Services でプロキシのサービスアカウントとして使用するアカウントを指定します。 このオプションは、Azure DevOps Services の場合にのみ、/change オプションと組み合わせて使用します。

Azure DevOps Services に使用される既定のサービスアカウントは " Account service です。"
continue 検証プロセスが警告を生成した場合でもコマンドの実行は継続されます。
コレクション Azure DevOps Services でホストされているプロジェクトコレクションの URL を形式で指定し AccountName.DomainName/CollectionName ます。
account Azure DevOps Services のサービスアカウントとして使用されるアカウントの名前を指定します。 アカウント名にスペースが含まれている場合は、名前を引用符 () で囲む必要があり " " ます。 アカウント名のすべての特殊文字は、コマンド ライン構文に従って指定する必要があります。
account Azure DevOps Server 配置の URL を形式で指定し ServerURL:Port/tfs ます。
PersonalAccessTokenFile 必要に応じて、個人用アクセストークンを含むファイルへのパスを指定します。 このトークンは、プロキシの登録時に、コレクションまたはアカウントの認証に使用されます。 (TFS 2018 Update 1 で追加)
inputs 省略可能。 プロキシの構成時に使用する追加の設定と値を指定します。

たとえば、およびの値を使用して、git GvfsProjectName GvfsRepositoryName 仮想ファイルシステム (gvfs) で使用する git リポジトリを構成できます (TFS 2018 Update 1 で追加)。

前提条件

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

注釈

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

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

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

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

Azure DevOps Proxy Server のインストールとプロキシの初期構成の詳細については、「 Azure DevOps プロキシサーバーをインストールしてリモートサイトをセットアップする方法 」を参照してください。 クライアントコンピューターでのプロキシの構成の詳細については、「 Team Foundation バージョン管理コマンドリファレンス」を参照してください。

TFSConfig Proxy /add|delete|change [/Collection:TeamProjectCollectionURL /account:AccountName]
            /Server:TeamFoundationServerURL [/inputs:Key1=Value1; Key2=Value2;...] [/Continue]
オプション 説明
/add Proxy.config ファイルのプロキシ リストに指定されたサーバーまたはコレクションを追加します。 /add を複数回実行して、複数のコレクションまたはサーバーを含めることができます。 Azure DevOps Services でホストされているコレクションで/add を使用する場合は、Azure DevOps Services で資格情報の入力を求められます。
/change Azure DevOps Services のサービスアカウントとして格納されている資格情報を変更します。 /Change オプションは Azure DevOps Services にのみ使用されます。Azure DevOps Server のローカル配置には使用しないでください。
/delete Proxy.config ファイルのプロキシ リストから指定されたサーバーまたはコレクションを削除します。
/account Azure DevOps Services でプロキシのサービスアカウントとして使用するアカウントを指定します。 このオプションは、Azure DevOps Services の場合にのみ、/change オプションと組み合わせて使用します。

Azure DevOps Services に使用される既定のサービスアカウントは " Account service です。"
/continue 検証プロセスが警告を生成した場合でもコマンドの実行は継続されます。
/Collection: teamprojectcollectionurl Azure DevOps Services でホストされているプロジェクトコレクションの URL を形式で指定し AccountName.DomainName/CollectionName ます。
アカウント: AccountName Azure DevOps Services のサービスアカウントとして使用されるアカウントの名前を指定します。 アカウント名にスペースが含まれている場合は、名前を引用符 () で囲む必要があり " " ます。 アカウント名のすべての特殊文字は、コマンド ライン構文に従って指定する必要があります。
アカウント: ServerURL Azure DevOps Server 配置の URL を形式で指定し ServerURL:Port/tfs ます。
/PersonalAccessTokenFile:P の規則 必要に応じて、個人用アクセストークンを含むファイルへのパスを指定します。 このトークンは、プロキシの登録時に、コレクションまたはアカウントの認証に使用されます。 (TFS 2018 Update 1 で追加)
/入力: Key1 = Value1;Key2 = Value2;... 省略可能。 プロキシの構成時に使用する追加の設定と値を指定します。

たとえば、 " gvfsprojectname と GvfsRepositoryName の値を使用して git " " " リポジトリを構成し、git Virtual File System (gvfs) で使用することができます (TFS 2018 Update 1 で追加)。

前提条件

プロキシ コマンドを使用するには、Team Foundation 管理者セキュリティグループのメンバーであり、プロキシサーバーの管理者である必要があります。 詳細については、「 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

The following example shows how to change the service account used by the proxy for the project collection hosted on Azure DevOps Services. The collection is named PhoneSaver, the account name used for Azure DevOps Services is HelenaPetersen.fabrikam.com, and the service account used by the proxy is being changed to "My Proxy Service Account". Because the account name contains spaces, quotation marks are used to enclose the name.

```console
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

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

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]
オプション 説明
Microsoft.analysisservices.sharepoint.integration.dll /Allを使用しない場合は必須です。 Analysis Services のデータベースのみがリビルドされるように指定します。 Analysis Services 用のデータベースが存在しない場合は、 /reportingdatasourcepassword オプションも使用する必要があります。
all /AnalysisServicesを使用しない場合は必須です。 Azure DevOps Server 使用するすべてのレポートデータベースおよび分析データベースを再構築するように指定します。
reportingDataSourcePassword TFS_Analysis データベースが存在しない場合は、必ず指定します。 SQL Server Reporting Services (TFSReports) のデータソースアカウントとして使用されるアカウントのパスワードを指定します。 詳細については、「 Azure DevOps Server のサービスアカウントと依存関係」を参照してください。

前提条件

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

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

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

詳細については、「 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.

RebuildWarehouse コマンドを使用して、Visual Studio TEAM FOUNDATION SERVER (TFS) で使用される SQL Server Reporting Services および SQL Server Analysis Services データベースを再構築できます。

TFSConfig RebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]
オプション 説明
/analysisServices /Allを使用しない場合は必須です。 Analysis Services のデータベースのみがリビルドされるように指定します。 Analysis Services 用のデータベースが存在しない場合は、 /reportingdatasourcepassword オプションも使用する必要があります。
/all /AnalysisServicesを使用しない場合は必須です。 Azure DevOps Server 使用するすべてのレポートデータベースおよび分析データベースを再構築するように指定します。
/reportingdatasourcepassword: 入力 TFS_Analysis データベースが存在しない場合は、必ず指定します。 SQL Server Reporting Services (TFSReports) のデータソースアカウントとして使用されるアカウントのパスワードを指定します。 詳細については、「 Azure DevOps Server のサービスアカウントと依存関係」を参照してください。

前提条件

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

  • Azure DevOps の管理コンソールを実行しているサーバー上の Team Foundation 管理者セキュリティグループと管理者セキュリティグループ

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

詳細については、「 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

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

TfsConfig registerDB /sqlInstance:<serverName> /databaseName:<databaseName>
オプション 説明
SQLInstance 必須です。 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前とインスタンスの名前を指定します。 インスタンスを指定する場合は、の形式を使用する必要があり ServerName\InstanceName ます。
databaseName 必須です。 構成データベースの名前を指定します。 既定の名前は Tfs_Configuration です。

前提条件

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

Registerdb を使用して、Visual Studio TEAM FOUNDATION SERVER (TFS) の構成データベースをホストするサーバーの名前を更新します。 このコマンドは構成データベースを新しいハードウェアに復元する場合、または配置のドメインを変更する場合に使用できます。

TFSConfig RegisterDB /SQLInstance:ServerName /databaseName: DatabaseName [/usesqlalwayson]
引数 説明
/SQLInstance: Server 必須です。 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前とインスタンスの名前を指定します。 インスタンスを指定する場合は、の形式を使用する必要があり ServerName\InstanceName ます。
/databaseName: DatabaseName 必須です。 構成データベースの名前を指定します。 既定の名前は Tfs_Configuration です。
/すべての alwayson 省略可能。 データベースが SQL Server の AlwaysOn 可用性グループの一部であることを指定します。 このオプションを構成すると、接続文字列に MultiSubnetFailover が設定されます。

詳細については、「 AlwaysOn 可用性グループ (SQL Server)」を参照してください。

前提条件

Registerdb コマンドを使用するには、azure DevOps のアプリケーション層サーバーの Team Foundation 管理者グループのメンバーであり、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 インスタンス TeamDatabases のサーバー ContosoMain にある構成データベースにリダイレクトします。

TFSConfig RegisterDB /SQLInstance:ContosoMain\TeamDatabases /databaseName:Tfs_Configuration

RemapDBs

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

TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
    [/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
    [/preview] [/continue]
オプション 説明
DatabaseName データベース自体の名前に加えて、Azure DevOps Server にマップするデータベースをホストするサーバーの名前を指定します。
SQLInstances 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前に加え、インスタンスの名前を指定します。

複数のサーバーを指定する場合は、サーバー名とインスタンス名の複数のペアを区切るためにコンマを使用する必要があります。
AnalysisInstance 省略可能。 SQL Server Analysis Services をホストするサーバーとインスタンスの名前を指定します。 このオプションを使用して、Analysis Services データベースをホストするサーバーとインスタンスを指定します。
AnalysisDatabaseName 省略可能。 /AnalysisInstanceオプションで指定したサーバー上に複数のデータベースがある場合に Azure DevOps Server で使用する Analysis Services データベースの名前を指定します。
preview 省略可能。 構成を更新するために実行する必要がある操作が表示されます。
continue 省略可能。 1つ以上のデータベースの検索中にエラーが発生した場合でも、 RemapDB コマンドを続行することを指定します。 [ 続行 ] オプションを使用すると、指定したサーバーでデータベースが見つからないコレクションは、構成データベースをホストするサーバーとインスタンスを使用するように再構成されます。

前提条件

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

注釈

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

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

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

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

TFSConfig RemapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
        [/AnalysisInstance:ServerName] [/AnalysisDatabaseName:DatabaseName]
        [/preview] [/continue] [/usesqlalwayson]
オプション 説明
/DatabaseName データベース自体の名前に加えて、Azure DevOps Server にマップするデータベースをホストするサーバーの名前を指定します。
Sqlinstances (& i):ServerName1,ServerName2 既定のインスタンス以外のインスタンスを使用する場合に、SQL Server を実行しているサーバーの名前に加え、インスタンスの名前を指定します。

複数のサーバーを指定する場合は、サーバー名とインスタンス名の複数のペアを区切るためにコンマを使用する必要があります。
/AnalysisInstance: Server 省略可能。 SQL Server Analysis Services をホストするサーバーとインスタンスの名前を指定します。 このオプションを使用して、Analysis Services データベースをホストするサーバーとインスタンスを指定します。
/AnalysisDatabaseName: DatabaseName 省略可能。 /AnalysisInstanceオプションで指定したサーバー上に複数のデータベースがある場合に Azure DevOps Server で使用する Analysis Services データベースの名前を指定します。
/preview 省略可能。 構成を更新するために実行する必要がある操作が表示されます。
/continue 省略可能。 1つ以上のデータベースの検索中にエラーが発生した場合でも、 RemapDB コマンドを続行することを指定します。 [ 続行 ] オプションを使用すると、指定したサーバーでデータベースが見つからないコレクションは、構成データベースをホストするサーバーとインスタンスを使用するように再構成されます。
/すべての alwayson 省略可能。 データベースが SQL Server の AlwaysOn 可用性グループの一部であることを指定します。 このオプションを構成すると、接続文字列に MultiSubnetFailover が設定されます。

詳細については、「 AlwaysOn 可用性グループ (SQL Server)」を参照してください。

前提条件

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

注釈

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

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

TFSConfig RemapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
            /SQLInstances:ContosoMain\TeamDatabases,Contoso2

RepairJobQueue

RepairJobQueue コマンドを使用して、展開とコレクションのホストに対して実行を停止したスケジュールされたジョブを修正します。

TfsConfig repairJobQueue

前提条件

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

注釈

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

TfsConfig repairJobQueue

コマンドの可用性: TFS 2015

RepairJobQueue コマンドを使用して、展開とコレクションのホストに対して実行を停止したスケジュールされたジョブを修正します。

TfsConfig repairJobQueue

前提条件

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

注釈

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

TFSConfig repairJobQueue

設定

設定 コマンドを使用すると、通知インターフェイスおよび 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]
オプション 説明
publicUrl Azure DevOps のアプリケーション層サーバーの URL を指定します。 この値は、Azure DevOps の構成データベースに格納されます。

前提条件

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

注釈

設定 コマンドは、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 のサーバーアドレスに使用される uniform resource LOCATOR (URL) に対する変更を自動化できます。 既定では、通知インターフェイスの URL とサーバー URL は Azure DevOps Server と一致しますが、個別の Url を構成することができます。 たとえば、Azure DevOps Server によって生成される自動電子メールに別の URL を使用する場合があります。 このツールをアプリケーション層から実行してすべてのサーバーを更新し、それらが新しい URL を使用するようにする必要があります。

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

TFSConfig Settings [/ServerURL:URL] [/NotificationURL:URL]
オプション 説明
/ServerURL: Azure DevOps のアプリケーション層サーバーの URL を指定します。 この値は、Azure DevOps の構成データベースに格納されます。
/Notificationurl: URL が Azure DevOps のアプリケーション層サーバーの URL と異なる場合に、電子メール通知のテキストで使用する URL を指定します。 この値は、構成データベースに格納されます。

前提条件

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

注釈

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

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

TFSConfig Settings /NotificationURL:http://contoso.example.com/tfs /ServerURL:http://contoso.example.com:8080/tfs

セットアップ

コマンドを実行するコンピューターで現在構成されている機能をアンインストールするには、 setup コマンドを使用します。

TfsConfig setup /uninstall:<feature[,feature,...]>
オプション 説明
uninstall コマンドを実行するコンピューターからアンインストールする1つ以上の機能を指定します。 オプションには、All、ApplicationTier、Search、VersionControlProxy があります。
オプション 説明
/uninstall コマンドを実行するコンピューターからアンインストールする1つ以上の機能を指定します。 オプションには、All、ApplicationTier、SharePointExtensions、Search、TeamBuild、および VersionControlProxy があります。
オプション 説明
/uninstall コマンドを実行するコンピューターからアンインストールする1つ以上の機能を指定します。 オプションには、All、ApplicationTier、SharePointExtensions、TeamBuild、VersionControlProxy などがあります。

前提条件

セットアップ コマンドを使用するには、Azure DevOps Administrators セキュリティグループのメンバーである必要があります。

次の例では、現在のコンピューターからすべての Azure DevOps Server 機能をアンインストールします。

TfsConfig setup /uninstall:ALL

次の例では、アプリケーション層をアンインストールし、現在のコンピューターから機能をビルドします。

TfsConfig setup /uninstall:ApplicationTier,TeamBuild

TCM

最新バージョンの Azure DevOps Server にアップグレードすると、テスト計画およびスイートを含む、テスト管理コンポーネントのアップグレードが自動的に試行されます。 自動移行に失敗した場合は、 TCM コマンドを使用して、テスト計画とテストスイートをそれぞれの作業項目の種類 (wit) に手動でアップグレードします。

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
オプション 説明
/upgradetestplan /Upgradestatusが使用されていない場合は必須です。

既存のテスト計画とテスト スイートを作業項目ベースのテスト計画とテスト スイートを指すように変換します。 既存のテスト管理データだけでなく、テスト ポイント、テスト実行、テスト結果などのその他の既存のテスト成果物間のリンクも更新します。
/upgradestatus /Upgradetestplanを使用しない場合は必須です。

指定されたプロジェクトのテストデータの移行状態を報告します。 指定されたプロジェクトにテスト計画が含まれているかどうかも表示します。
/CollectionName: CollectionName 必須です。 テストデータを移行するプロジェクトを含むプロジェクトコレクションを指定します。または、移行の状態を確認します。

プロジェクトコレクションの名前にスペースが含まれている場合は、名前を引用符で囲みます (例、 " Fabrikam Fiber コレクション) " 。
/TeamProjectName: TeamProjectName 必須です。 テストデータを移行するプロジェクトを指定します。または、移行の状態を確認します。 このプロジェクトは、 /collectionName パラメーターを使用して指定したコレクションで定義されている必要があります。

プロジェクト名にスペースが含まれている場合は、名前を引用符で囲みます。たとえば、「My Project」と指定し " " ます。

前提条件

あなたは Team Foundation 管理者セキュリティ グループのメンバーで、アプリケーション層サーバーの管理者である必要があります。 「 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 にアップグレードすると、テスト計画およびスイートを含む、テスト管理コンポーネントのアップグレードが自動的に試行されます。 自動移行に失敗した場合は、 TCM コマンドを使用して、テスト計画とテストスイートをそれぞれの作業項目の種類 (wit) に手動でアップグレードします。

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
オプション 説明
/upgradetestplan /Upgradestatusが使用されていない場合は必須です。

既存のテスト計画とテスト スイートを作業項目ベースのテスト計画とテスト スイートを指すように変換します。 既存のテスト管理データだけでなく、テスト ポイント、テスト実行、テスト結果などのその他の既存のテスト成果物間のリンクも更新します。
/upgradestatus /Upgradetestplanを使用しない場合は必須です。

指定されたプロジェクトのテストデータの移行状態を報告します。 指定されたプロジェクトにテスト計画が含まれているかどうかも表示します。
/CollectionName: CollectionName 必須です。 テストデータを移行するプロジェクトを含むプロジェクトコレクションを指定します。または、移行の状態を確認します。

プロジェクトコレクションの名前にスペースが含まれている場合は、名前を引用符で囲みます (例、 " Fabrikam Fiber コレクション) " 。
/TeamProjectName: TeamProjectName 必須です。 テストデータを移行するプロジェクトを指定します。または、移行の状態を確認します。 このプロジェクトは、 /collectionName パラメーターを使用して指定したコレクションで定義されている必要があります。

プロジェクト名にスペースが含まれている場合は、名前を引用符で囲みます。たとえば、「My Project」と指定し " " ます。

前提条件

あなたは Team Foundation 管理者セキュリティ グループのメンバーで、アプリケーション層サーバーの管理者である必要があります。 「 Azure DevOps Server に対する管理者権限の設定」を参照してください。

注釈

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

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]
オプション 説明
create 指定された名前とパラメーターで無人セットアップ ファイルを作成します。
[構成] 無人セットアップファイルと指定したパラメーターを使用して Azure DevOps Server を構成します。 このオプションでは、/type または/unattendfile を使用する必要があります。
使用する構成の種類を指定します。 /configure を使用する場合は、/type と /unattendfile のどちらかが必須ですが、両方を使用することはできません。
unattendfile 初期パラメーターが /create と /configure のどちらかに応じて、作成または使用する無人セットアップ ファイルを指定します。 /configure を使用する場合は、/unattendfile と /type のどちらかが必須です。
inputs 省略可能。 /create を使用する場合は、無人セットアップ ファイルの作成時に使用する設定と値を指定します。 /configure を使用する場合は、無人セットアップ ファイルと組み合わせて使用する追加の設定と値を指定します。

/inputs を使用する代わりに、任意のプレーンテキスト エディターを使って手動で無人セットアップ ファイルを編集することができます。 これは、 Serviceaccountpassword PersonalAccessToken などの特定の入力型に対して必要です。これらのシークレット値は、 /入力 パラメーターを使用して設定することはできません。
確認 省略可能。 無人セット ファイル、入力、構成の種類に基づいた検証チェックを実行するのみの構成の実行を指定します。 完全な構成を実行する代わりになるものです。
continue 省略可能。 検証チェックからの警告に関係なく /create または /configure を継続することを指定します。
InstallType 説明
NewServerBasic Azure DevOps Server のための重要な開発サービスを構成します。 これには、ソース管理、作業項目、ビルド、および必要に応じて検索が含まれます。
NewServerAdvanced 不可欠な開発サービスを構成し、Reporting Services との統合をオプションで構成できるようにします。
アップグレード サポートされていた以前のリリースから現在のバージョンへの Azure DevOps Server をアップグレードします。
PreProductionUpgrade 実稼働前環境で既存の Azure DevOps Server 展開のアップグレードをテストします。 これは通常、運用バックアップから復元されたデータベースを使用して行われます。 このシナリオには、新しい展開が運用環境のデプロイに干渉しないようにするための追加の手順が含まれています。
ApplicationTierOnlyBasic 指定された構成データベースの既存の設定を使用して、新しいアプリケーション層を構成します。 このオプションを使用すると、既存の設定を使用して新しいアプリケーション層を迅速に稼働させることができます。 既存の設定を変更できるようにするには、代わりに Advanced ApplicationTierOnlyAdvanced type を使用します。
ApplicationTierOnlyAdvanced すべての設定に対してフルコントロールを使用して、新しいアプリケーション層を構成します。 設定は、既定では、指定された構成データベースの既存の値に設定されます。 既存の設定をすべて保持する場合は、代わりに ApplicationTierOnlyBasic 型を使用します。
複製 既存のデプロイの複製である新しい Azure DevOps Server 展開を構成します。 通常、これは、運用バックアップから復元されたデータベースを使用して、構成の変更、拡張、およびその他の変更をテストできる環境を作成するために行われます。 このシナリオには、新しい展開が運用環境のデプロイに干渉しないようにするための追加の手順が含まれています。
プロキシ バージョンコントロールプロキシサービスを構成します。

前提条件

  • ソフトウェアをインストールしているコンピューター上の管理者グループのメンバーになる必要があります。

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

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

注釈

無人セットアップ コマンドを使用して Azure DevOps Server を構成する前に、配置の一部として使用する サービスアカウントを作成する必要があります。 選択したインストールの種類に不可欠なすべてのソフトウェアをインストールする必要もあります。 これには Azure DevOps Server 自体も含まれます。 Azure DevOps Server をインストールする必要がありますが、 無人セットアップ によって実行されるため、構成する必要はありません。

無人 コマンドを実行すると Azure DevOps Server コンポーネントが構成されます。 ソフトウェアの初期インストールは実行しません。 コンピューター上に bits がインストールされてから、指定に従ってソフトウェアを構成します。

次の例は、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 プロキシサーバーの構成用の無人セットアップファイルを作成する方法を示しています。

重要

この例では、管理者が認証に個人用アクセストークンを使用する場合、個人用アクセストークンの値を指定するためにファイルを手動で編集する必要があります。 これを行うには、次のように作成された無人セットアップファイルに個人用アクセストークンの行を追加します PersonalAccessToken=PersonalAccessTokenValue

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

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

重要

この例では、無人セットアップ ファイルの作成後に、管理者がビルド サービス アカウントのパスワードを指定するためにファイルを手動で編集します。 を使用してパスワードを入力として追加しても、 ServiceAccountPassword=Password; パスワード情報はファイルに追加されません。

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

コマンドの可用性: TFS 2018、TFS 2017、TFS 2015、TFS 2013

無人 コマンドは、Azure DevOps Server と構成プロセスに精通しており、別のコンピューターに Azure DevOps Server をインストールする必要があるユーザー向けに設計されています。

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

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

このプロセスを使用すると、インストールプロセス中に入力を指定しなくても、開始から終了までの Azure DevOps Server を構成できます。 複数インストールの場合は、これにより、複数のサーバーに全く同じ構成パラメーターが使用されていることの確認も容易になります。

TFSConfig unattend /create|unattend /type:InstallType /unattendfile:ConfigurationFileName [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]
オプション 説明
/create 指定された名前とパラメーターで無人セットアップ ファイルを作成します。
/configure 無人セットアップファイルと指定したパラメーターを使用して Azure DevOps Server を構成します。 このオプションでは、/type または/unattendfile を使用する必要があります。
/type: InstallType

使用する構成の種類を指定します。

  • [基本]: SQL Server Express を含む、基本構成の Azure DevOps Server を構成します。

  • Standard: 標準の単一サーバー構成で Azure DevOps Server を構成します。

  • ATOnly: 既存の Azure DevOps Server デプロイに対して追加のアプリケーション層を構成します。

  • Build: Team Foundation ビルド サービスを構成します。

  • プロキシ: Azure DevOps Proxy サーバーを構成します。

  • SPInstall: Azure DevOps Server 配置で使用する SharePoint Foundation 2013 をインストールして構成します。

  • アップグレード: 以前のバージョンの Azure DevOps Server をソフトウェアの最新バージョンにアップグレードします。

    このコマンドに /configure を指定して実行する前に、そのバージョンをダウンロードしてローカルでインストールする必要があります。

  • SPExtensions: Azure DevOps Server 用に SharePoint 拡張機能を構成します。

/configure を使用する場合は、/type と /unattendfile のどちらかが必須ですが、両方を使用することはできません。

/unattendfile: configurationfilename 初期パラメーターが /create と /configure のどちらかに応じて、作成または使用する無人セットアップ ファイルを指定します。 /configure を使用する場合は、/unattendfile と /type のどちらかが必須です。
/入力: Key1 = Value1;Key2 = Value2;... 省略可能。 /create を使用する場合は、無人セットアップ ファイルの作成時に使用する設定と値を指定します。 /configure を使用する場合は、無人セットアップ ファイルと組み合わせて使用する追加の設定と値を指定します。

/inputs を使用する代わりに、任意のプレーンテキスト エディターを使って手動で無人セットアップ ファイルを編集することができます。 これは、 Serviceaccountpassword PersonalAccessToken などの特定の入力型に対して必要です。これらのシークレット値は、 /入力 パラメーターを使用して設定することはできません。
/verify 省略可能。 無人セット ファイル、入力、構成の種類に基づいた検証チェックを実行するのみの構成の実行を指定します。 完全な構成を実行する代わりになるものです。
/continue 省略可能。 検証チェックからの警告に関係なく /create または /configure を継続することを指定します。
/? 省略可能。 unattend コマンドに関するコマンド ライン ヘルプを提供します。

前提条件

  • ソフトウェアをインストールしているコンピューター上の管理者グループのメンバーになる必要があります。

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

注釈

無人セットアップ コマンドを使用して Azure DevOps Server を構成する前に、配置の一部として使用する サービスアカウントを作成する必要があります。 選択したインストールの種類に不可欠なすべてのソフトウェアをインストールする必要もあります。 これには Azure DevOps Server 自体も含まれます。 Azure DevOps Server をインストールする必要がありますが、 無人セットアップ によって実行されるため、構成する必要はありません。

無人コマンドを実行すると Azure DevOps Server コンポーネントが構成されます。 ソフトウェアの初期インストールは実行しません。 コンピューター上に bits がインストールされてから、指定に従ってソフトウェアを構成します。

次の例は、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 プロキシサーバーの構成用の無人セットアップファイルを作成する方法を示しています。

重要: この例では、管理者が認証に個人用アクセストークンを使用する場合、個人用アクセストークンの値を指定するためにファイルを手動で編集する必要があります。 これを実現するには、次のように作成された無人セットアップファイルに個人用アクセストークンの行を追加し " ます。 PersonalAccessToken = PersonalAccessTokenValue のように " なります。

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

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

重要:
この例では、無人セットアップ ファイルの作成後に、管理者がビルド サービス アカウントのパスワードを指定するためにファイルを手動で編集します。 Serviceaccountpassword = Password を使用してパスワードを入力として追加しても、 " " パスワード情報はファイルに追加されません。

TFSConfig Unattend /create /type:build /unattendfile:configTFSBuild.ini
        /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig
        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番目のコマンドは、Team Foundation ビルドが構成されたサーバーの名前 (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

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

TfsConfig zipLogs

TfsConfig zipLogs

非推奨のコマンド

ライセンス

ライセンス コマンドを使用して、Azure DevOps Server の展開のライセンスキーを表示、変更、または拡張することができます。

TFSConfig License [/ProductKey:Key] [/extend [NewTrialID]]
オプション 説明
/ProductKey: レジストリ 展開のライセンスキーがキーの値で更新されることを指定します。
/拡張 Azure DevOps Server の評価版ライセンス期間を30日間延長することを指定します。 このオプションは、新しい評価版 ID を取得せずに1回だけ使用できます。 2つ目の拡張機能が必要な場合は、Microsoft から2番目の試用版ライセンスを取得する必要があります。

前提条件

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

注釈

デプロイのライセンスを対話的に表示、変更、または変更するには、Azure DevOps の管理コンソールを使用します。 詳細については、「 Azure DevOps 管理コンソールを開きAzure DevOps Server のプロダクトキーを検索または変更する」を参照してください。

次の例は、Azure DevOps Server の展開のライセンス情報を表示する方法を示しています。 この例では、展開は試用版ライセンスを使用しています。

TFSConfig License

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright © Microsoft Corporation. All rights reserved.
    Team Foundation Server Standard license
    The following features are installed:
    Team Foundation Server
    Build Services
    Build: 21106.00
    Product ID: 01234-567-8910
    Trial license with 74 days remaining, expiring on 6/30/2010
    Trial ID: ABCD-EFGH-IJKL

TCM

最新バージョンの Azure DevOps Server にアップグレードすると、テスト計画およびスイートを含む、テスト管理コンポーネントのアップグレードが自動的に試行されます。 自動移行に失敗した場合は、 TCM コマンドを使用して、テスト計画とテストスイートをそれぞれの作業項目の種類 (wit) に手動でアップグレードします。

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
オプション 説明
/upgradetestplan /Upgradestatusが使用されていない場合は必須です。

既存のテスト計画とテスト スイートを作業項目ベースのテスト計画とテスト スイートを指すように変換します。 既存のテスト管理データだけでなく、テスト ポイント、テスト実行、テスト結果などのその他の既存のテスト成果物間のリンクも更新します。
/upgradestatus /Upgradetestplanを使用しない場合は必須です。

指定されたプロジェクトのテストデータの移行状態を報告します。 指定されたプロジェクトにテスト計画が含まれているかどうかも表示します。
/CollectionName: CollectionName 必須です。 テストデータを移行するプロジェクトを含むプロジェクトコレクションを指定します。または、移行の状態を確認します。

プロジェクトコレクションの名前にスペースが含まれている場合は、名前を引用符で囲みます (例、 " Fabrikam Fiber コレクション) " 。
/TeamProjectName: TeamProjectName 必須です。 テストデータを移行するプロジェクトを指定します。または、移行の状態を確認します。 このプロジェクトは、 /collectionName パラメーターを使用して指定したコレクションで定義されている必要があります。

プロジェクト名にスペースが含まれている場合は、名前を引用符で囲みます。たとえば、「My Project」と指定し " " ます。

前提条件

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

注釈

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

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"

[インポート]

インポートコマンドは、TFS 2013 で非推奨とされました。 以前のバージョンについては、以下を参照してください。

以前のバージョンの Azure DevOps Server からのデータおよびプロジェクトのアップグレードに関するサポートが必要な場合は、「 Azure DevOps Server をアップグレードする」または「 Microsoft サポートに問い合わせる」を参照してください。

PrepareSQL

TFS 2012 で prepareSQL コマンドが実行されました。 以前のバージョンについては、以下を参照してください。

修復

修復コマンドは、TFS 2012 では実行されませんでした。 以前のバージョンについては、以下を参照してください。

失敗したデータベース修正プログラムの後にストアドプロシージャを修復する必要がある場合は、 Microsoft サポートにお問い合わせください。

診断

診断コマンドは、TFS 2013 で非推奨とされました。 以前のバージョンについては、以下を参照してください。

アプリケーション層とデータ層サーバーのソフトウェア更新プログラムの間の潜在的な不一致の診断に関するサポートが必要な場合は、 開発者コミュニティサポートにお問い合わせください。 (Azure DevOps Server)

更新プログラム

Updates コマンドは、TFS 2013 では非推奨とされました。以前のバージョンについては、次を参照してください。

Azure DevOps Server のデータベースにないソフトウェア更新プログラムのインストールに関するサポートが必要な場合は、 Microsoft サポートに問い合わせてください。

PrepareClone

このコマンドは、TFS 2017 では非推奨とされました。

この コマンドは 、スケジュールされたバックアップ、SharePoint、およびレポートリソースに関する情報を Azure DevOps Server の展開から削除します。 このコマンドは、次の2つの状況で使用されます。

  • 展開を新しいハードウェアに移動するときに、以前の展開を引き続き使用する場合
  • Azure DevOps Server の展開を複製する場合

どちらの場合も、このコマンドを実行することが重要です。 そうしないと、元のリソースが元のサーバーと新しいサーバーの両方で使用されます。 オリジナルのサーバーと新しいサーバーの両方が有効で、一定期間に、同じ SharePoint またはレポート リソースを指している場合は、データベースが破損する可能性があります。

重要

このコマンドは、Azure DevOps Server を移動するか複製するかにかかわらず、構成の前に実行する必要があります。 構成後に実行すると、データベース内のコンテンツと web.config ファイル内のコンテンツとの間に不整合が生じる可能性があります。 これらの不整合により、サーバーがオフラインになる場合があります。 移動または複製された Azure DevOps Server デプロイを既に構成していて、コマンドを実行する必要があることがわかっている場合は、次の手順に従います。 まず、お使いのサーバーを休止します。 次に、PrepareClone コマンド、ChangeServerID コマンド、および RemapDBs コマンドの順に実行します。 最後に、サーバーを休止解除します。

TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:TFSConfigurationDatabaseName
        [/notificationURL: TFSURL] [/usesqlalwayson]
オプション 実行内容
/DatabaseName 構成データベース自体の名前に加えて、Azure DevOps Server にマップするデータベースをホストするサーバーの名前を指定します。
/SQLInstance: Server Azure DevOps Server の1つ以上のデータベースをホストするサーバーとしてマップするサーバーの名前を指定します。 既定のインスタンス以外のインスタンスがデータベースをホストする場合は、インスタンスの名前も指定する必要があります。 次の形式を使用します。 ServerName < /strong > InstanceName です。
/Notificationurl: TFSURL 省略可能。 アプリケーション層サーバーの通知 URL を指定します。
/すべての alwayson 省略可能。 データベースが SQL Server の AlwaysOn 可用性グループの一部であることを指定します。 このオプションを構成すると、接続文字列に MultiSubnetFailover が設定されます。

詳細については、「 AlwaysOn 可用性グループ (SQL Server)」を参照してください。

前提条件

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

注釈

元のインストールを新しいハードウェアに移動し、元の展開 Azure DevOps Server とハードウェアを引き続き使用する場合、または Azure DevOps Server の展開をテスト目的で複製する場合 は、[コマンドの 作成] を使用して Azure DevOps Server を再構成します。 構成の複製をサポートするには、TFSConfig PrepareClone と、TFSConfig RemapDBs および TFSConfig ChangeServerID を組み合わせて使用します。

次の例は、NewFabrikamTFS という名前の移動された Azure DevOps Server に対してコマンドを使用して、古いバックアップ、レポート、および SharePoint リソース情報を削除する方法を示しています。 この情報が削除されていない場合、Azure DevOps Server の元の展開でも同じリソースが使用され、データベースが破損します。 この例では、移動した Azure DevOps Server をサポートする SQL Server も NewFabrikamTFS という名前で、インスタンスは既定のインスタンスであるため、特定のインスタンス情報は必要ありません。サーバー名だけが必要です。

TFSConfig PrepareClone /SQLInstance:NewFabrikamTFS /DatabaseName:TFS_Configuration

ライセンス

ライセンス コマンドを使用して、Azure DevOps Server の展開のライセンスキーを表示、変更、または拡張することができます。

TFSConfig License [/ProductKey:Key] [/extend [NewTrialID]]
オプション 説明
/ProductKey: レジストリ 展開のライセンスキーがキーの値で更新されることを指定します。
/拡張 Azure DevOps Server の評価版ライセンス期間を30日間延長することを指定します。 このオプションは、新しい評価版 ID を取得せずに1回だけ使用できます。 2つ目の拡張機能が必要な場合は、Microsoft から2番目の試用版ライセンスを取得する必要があります。

前提条件

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

注釈

デプロイのライセンスを対話的に表示、変更、または変更するには、Azure DevOps の管理コンソールを使用します。 詳細については、「 Azure DevOps 管理コンソールを開きAzure DevOps Server のプロダクトキーを検索または変更する」を参照してください。

次の例は、Azure DevOps Server の展開のライセンス情報を表示する方法を示しています。 この例では、展開は試用版ライセンスを使用しています。

TFSConfig License

TFSConfig - Team Foundation Server Configuration Tool
Copyright © Microsoft Corporation. All rights reserved.
Team Foundation Server Standard license
The following features are installed:
Team Foundation Server
Build Services
Build: 21106.00
Product ID: 01234-567-8910
Trial license with 74 days remaining, expiring on 6/30/2010
Trial ID: ABCD-EFGH-IJKL
TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
オプション 説明
/upgradetestplan /Upgradestatusが使用されていない場合は必須です。

既存のテスト計画とテスト スイートを作業項目ベースのテスト計画とテスト スイートを指すように変換します。 既存のテスト管理データだけでなく、テスト ポイント、テスト実行、テスト結果などのその他の既存のテスト成果物間のリンクも更新します。
/upgradestatus /Upgradetestplanを使用しない場合は必須です。

指定されたプロジェクトのテストデータの移行状態を報告します。 指定されたプロジェクトにテスト計画が含まれているかどうかも表示します。
/CollectionName: CollectionName 必須です。 テストデータを移行するプロジェクトを含むプロジェクトコレクションを指定します。または、移行の状態を確認します。

プロジェクトコレクションの名前にスペースが含まれている場合は、名前を引用符で囲みます (例、 " Fabrikam Fiber コレクション) " 。
/TeamProjectName: TeamProjectName 必須です。 テストデータを移行するプロジェクトを指定します。または、移行の状態を確認します。 このプロジェクトは、 /collectionName パラメーターを使用して指定したコレクションで定義されている必要があります。

プロジェクト名にスペースが含まれている場合は、名前を引用符で囲みます。たとえば、「My Project」と指定し " " ます。

前提条件

あなたは Team Foundation 管理者セキュリティ グループのメンバーで、アプリケーション層サーバーの管理者である必要があります。 「 Team Foundation Server に対する管理者権限の設定」を参照してください。

注釈

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

TCM コマンドを使用するには、まず、プロジェクトにテスト計画作業項目定義とテスト計画カテゴリをインポートする必要があります。 移行の詳細と、このコマンドを使用するタイミングについては、「 テスト管理をサポートするための手動更新」を参照してください。

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

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

TCM コマンドは、既存のテストデータの自動移行が失敗した場合にのみ使用します。 移行の詳細と、このコマンドを使用するタイミングについては、「 テスト管理をサポートするための手動更新」を参照してください。

サーバーのアップグレードが行われる前に定義されたテスト計画またはテストスイートにアクセスできない場合は、 TFSCONFIG TCM upgradeStatus を実行して移行の状態を確認します。

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

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

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

[インポート]

インポートコマンドは、TFS 2013 で非推奨とされました。 以前のバージョンについては、以下を参照してください。

以前のバージョンの Azure DevOps Server からのデータおよびプロジェクトのアップグレードに関するサポートが必要な場合は、「 Azure DevOps Server をアップグレードする」または「 Microsoft サポートに問い合わせる」を参照してください。

PrepareSQL

TFS 2012 で prepareSQL コマンドが実行されました。 以前のバージョンについては、以下を参照してください。

修復

修復コマンドは、TFS 2012 では実行されませんでした。 以前のバージョンについては、以下を参照してください。

失敗したデータベース修正プログラムの後にストアドプロシージャを修復する必要がある場合は、 Microsoft サポートにお問い合わせください。

診断

診断コマンドは、TFS 2013 で非推奨とされました。 以前のバージョンについては、以下を参照してください。

アプリケーション層とデータ層サーバーのソフトウェア更新プログラムの間の潜在的な不一致の診断に関するサポートが必要な場合は、 開発者コミュニティサポートにお問い合わせください。 (Azure DevOps Server)

更新プログラム

Updates コマンドは、TFS 2013 で非推奨とされました。 以前のバージョンについては、以下を参照してください。

Azure DevOps Server のデータベースにないソフトウェア更新プログラムのインストールに関するサポートが必要な場合は、 Microsoft サポートに問い合わせてください。

PrepareClone

このコマンドは、TFS 2017 では非推奨とされました。

コマンドの可用性: TFS 2015 および TFS 2013

この コマンドは 、スケジュールされたバックアップ、SharePoint、およびレポートリソースに関する情報を Azure DevOps Server の展開から削除します。 このコマンドは、次の2つの状況で使用されます。

  • 展開を新しいハードウェアに移動するときに、以前の展開を引き続き使用する場合
  • Azure DevOps Server の展開を複製する場合

どちらの場合も、このコマンドを実行することが重要です。 そうしないと、元のリソースが元のサーバーと新しいサーバーの両方で使用されます。 オリジナルのサーバーと新しいサーバーの両方が有効で、一定期間に、同じ SharePoint またはレポート リソースを指している場合は、データベースが破損する可能性があります。

重要:
このコマンドは、Azure DevOps Server を移動するか複製するかにかかわらず、構成の前に実行する必要があります。 構成後に実行すると、データベース内のコンテンツと web.config ファイル内のコンテンツとの間に不整合が生じる可能性があります。 これらの不整合により、サーバーがオフラインになる場合があります。 移動または複製された Azure DevOps Server デプロイを既に構成していて、コマンドを実行する必要があることがわかっている場合は、次の手順に従います。 まず、お使いのサーバーを休止します。 次に、PrepareClone コマンド、ChangeServerID コマンド、および RemapDBs コマンドの順に実行します。 最後に、サーバーを休止解除します。

TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:TFSConfigurationDatabaseName
    [/notificationURL: TFSURL] [/usesqlalwayson]
オプション 実行内容
/DatabaseName 構成データベース自体の名前に加えて、Azure DevOps Server にマップするデータベースをホストするサーバーの名前を指定します。
/SQLInstance: Server Azure DevOps Server の1つ以上のデータベースをホストするサーバーとしてマップするサーバーの名前を指定します。 既定のインスタンス以外のインスタンスがデータベースをホストする場合は、インスタンスの名前も指定する必要があります。 次の形式を使用します。 ServerName < /strong > InstanceName です。
/Notificationurl: TFSURL 省略可能。 アプリケーション層サーバーの通知 URL を指定します。
/すべての alwayson 省略可能。 データベースが SQL Server の AlwaysOn 可用性グループの一部であることを指定します。 このオプションを構成すると、接続文字列に MultiSubnetFailover が設定されます。

詳細については、「 AlwaysOn 可用性グループ (SQL Server)」を参照してください。

前提条件

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

注釈

元のインストールを新しいハードウェアに移動し、元の展開 Azure DevOps Server とハードウェアを引き続き使用する場合、または Azure DevOps Server の展開をテスト目的で複製する場合 は、[コマンドの 作成] を使用して Azure DevOps Server を再構成します。 構成の複製をサポートするには、TFSConfig PrepareClone と、TFSConfig RemapDBs および TFSConfig ChangeServerID を組み合わせて使用します。

次の例は、NewFabrikamTFS という名前の移動された Azure DevOps Server に対してコマンドを使用して、古いバックアップ、レポート、および SharePoint リソース情報を削除する方法を示しています。 この情報が削除されていない場合、Azure DevOps Server の元の展開でも同じリソースが使用され、データベースが破損します。 この例では、移動した Azure DevOps Server をサポートする SQL Server も NewFabrikamTFS という名前で、インスタンスは既定のインスタンスであるため、特定のインスタンス情報は必要ありません。サーバー名だけが必要です。

TFSConfig PrepareClone /SQLInstance:NewFabrikamTFS /DatabaseName:TFS_Configuration