次の方法で共有

アプリケーションを配置するためのリリース管理ツール

  • [アーティクル]

各リリース アクションでは、リリース管理ツールを使用します。 たとえば、コマンド ライン ランナーはアクションに特定の実行可能ファイルを実行するツールです。 指定されたツールがサポートしないタスクを実行する必要がある場合は、独自のカスタム ツールを生成し、カスタム リリース アクションに追加できます。 また、このツールはアプリのコンポーネントを配置するために使用できます。

ツールの一覧と Release Management に用意されているパラメーターを次に示します。

Database Deployment Agent - スクリプトの実行

このツールでは、特定のデータベースで SQL クエリを実行できます。 これは SQL Server に付属する標準の sqlcmd 実行可能ファイルに基づいています。 この実行可能ファイルの詳細については、sqlcmd のドキュメントを参照してください。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-S

ServerName

○

SQL データベースのサーバー名。

-i

ScriptName

○

実行するスクリプトの名前。

-b

N/A

Ｘ

このパラメーターはスイッチです。 このパラメーターを指定した場合、エラーが発生するとバッチが中止されます。

Reporting Services Deployment Agent

このツールでは、Reporting Services レポートと関連オブジェクトを配置できます。 これは、カスタムのリリース管理実行可能ファイルに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-s

serverUrl

○

Reporting Services サーバーの完全な URL。

-l

itemLocation

○(複数の項目が存在する場合)

項目の場所。 指定した場合、フォルダーを指定する必要があります (-f)。

-f

folder

○(複数の項目が存在する場合)

項目のフォルダー。 指定した場合、項目の場所を指定する必要があります (-l)。

-t

○

処理する項目の種類。 有効な値は以下のものがあります。

  • レポート

  • Picture

-sp

Ｘ

項目をフィルター処理するために使用する検索パターンの一覧。 検索パターンはコンマまたはセミコロンで区切って指定する必要があります (たとえば、*.bmp;*.jpg)。 指定しない場合、検索パターンは選択済み項目の種類に基づいて次のようになります (-t)。

  • Report: *.rdl

  • Picture: *.bmp、*.gif、*.jpg、*.jpeg、*.png

-i

○(項目が 1 つの場合)

項目のファイル。 指定した場合、項目の名前を指定する必要があります (-n)。 1 つの項目を配置する必要がある場合に、このパラメーターを使用します。 その場合、項目の場所のパラメーター (-l) とフォルダーのパラメーター (-f) は指定しないでください。

-n

○(項目が 1 つの場合)

項目の名前。 指定した場合、項目ファイルを指定する必要があります (-i)。 1 つの項目を配置する必要がある場合に、このパラメーターを使用します。 その場合、項目の場所のパラメーター (-l) とフォルダーのパラメーター (-f) は指定しないでください。

-log

Ｘ

指定された名前を持つログ ファイルが物理ディレクトリに生成されます。

-o

N/A

Ｘ

このパラメーターはスイッチです。 このパラメーターを指定すると、出力先が既に存在する場合、それが上書きされます。

-ds ds1,...,dsN

項目に関連付けるすべてのデータ ソースのコンマ区切りの完全修飾名。 これらでは、大文字と小文字が区別されます。 このオプションはレポートにのみ適用されます。 データ ソースは、[名前:] 参照の形式になります。 名前は、参照が置換されるレポートに指定される、データ ソースの名前です。 参照は、レポートに使用されるターゲット サーバーのデータ ソースへの完全修飾参照です。

MSI Deployment Agent

このツールでは、MSI を配置することができます。 新しい製品をインストールする前に、製品の以前のインストールをアンインストールします。 これは、カスタムのリリース管理 PowerShell スクリプトに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-command

N/A

○

固定値 ./msiexec.ps1。

-MsiFileName

Installer

○

インストールする .msi ファイルの完全パス (必要な場合) と名前。

-MsiCustomArgs

MsiCustomArgs

Ｘ

.msi ファイルをインストールするために使用するカスタム引数。 この引数は msiexec 実行可能ファイルに直接渡されます。 カスタム引数が不要な場合、引数からこのパラメーターを削除する必要があります。

-PrevProductName

Ｘ

.msi ファイルをインストールする前にアンインストールする、以前の製品名を指定できます。 既定では、インストールする .msi ファイルにある製品名が使用されます。

XCopy Deployment Agent

このツールでは、特定のコピー先にパッケージの場所をコピーできます。 これは、カスタムのリリース管理バッチ スクリプトに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-source

N/A

○

すべてのソースの場所をコピーする必要があることを指定する固定値。

-destination

Installation Path

○

コピー先。

コマンド ライン ランナー

このツールは、特定の実行可能ファイルを実行します。 これは、カスタムのリリース管理 PowerShell スクリプトに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-file

N/A

○

固定値 ./RunCommandLine.ps1。

-FilePath

FilePath

○

実行する実行可能ファイルの完全パス (必要な場合) とファイル名。

-Arguments

引数

Ｘ

実行可能ファイルを実行する際に必要な引数。

-UserDomain

UserDomain

Ｘ

特定のユーザーとして実行可能ファイルを実行する必要がある場合に使用する、ユーザーのドメイン。 指定しない場合は、ローカル ユーザーが使用されます (. .\localuser) であると見なされます。

-UserName

UserName

Ｘ

特定のユーザーとして実行可能ファイルを実行する必要がある場合に使用する、ユーザーの名前。

-UserPassword

UserPassword

Ｘ

特定のユーザーとして実行可能ファイルを実行する必要がある場合に使用する、ユーザーのパスワード。

Windows レジストリ マネージャー

このツールでは、Windows のレジストリ情報を操作できます。 これは、カスタムのリリース管理 PowerShell スクリプトに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-command

N/A

○

固定値 ./ManageWindowsRegistry.ps1。

-Action

動作

○

実行するアクション。 有効な値は以下のものがあります。

  • CreateKey: 新しいレジストリ キーを作成します。

  • ModifyKey: レジストリ キーまたはそのキーのデータを変更します。

  • DeleteKey: レジストリ キーと、そのすべての値およびサブキーを削除します。

  • CreateValue: キーの下に、新しいレジストリ値を作成します。

  • ModifyValue: キーの下にあるレジストリ値を変更します。

  • DeleteValue: キーの下にあるレジストリ値を削除します。

-OperatingSystemType

Ｘ

キーと値が 32 ビットまたは 64 ビットのレジストリでアクセスされるかどうかを示します。 指定されていない場合、既定は 32 ビットです。

-RegistryKey

RegistryKey

○

レジストリ キーのパスと名前 (たとえば、HKLM\Software\MyKey)。

-RegistryValue

×*

変更が適用されるレジストリ値 (たとえば、MyValue)。 CreateValue、ModifyValue、および DeleteValue で必須です。

-ValueType

Ｘ

対象となる値の種類。 指定できる値は次のとおりです。

  • REG_SZ: 文字列 (指定がない場合の既定値)

  • REG_QWORD_LITTLE_ENDIAN: リトル エンディアン形式の 64 ビットの数値

  • REG_QWORD: 64 ビットの数値

  • REG_NONE: 値なし

  • REG_MULTI_SZ: 複数行文字列 (区切りには \0 を使用)

  • REG_LINK: シンボリック リンク

  • REG_EXPAND_SZ: 環境変数への展開されていない参照を備えた文字列

  • REG_DWORD_BIG_ENDIAN: ビッグ エンディアン形式の 32 ビットの数値

  • REG_DWORD_LITTLE_ENDIAN: リトル エンディアン形式の 32 ビットの数値

  • REG_DWORD: 32 ビットの数値

  • REG_BINARY: 任意の形式のバイナリ データ

-RegistryData

Ｘ

キーの値 (CreateValue または ModifyValue を使用する場合) またはキーの既定値 (CreateKey または ModifyKey) に適用するデータ。

-RegistryKeyDestination

×*

ModifyKey アクションを使用してレジストリ キーの名前を変更する際に使用するレジストリ キー。 次に例を示します。

  • RegistryKey = HKLM\Software\MyKey

  • RegistryKeyDestination = HKLM\Software\MyModifiedKey (ModifyKey の場合に必要)

Windows 共通 IO

このツールでは、Windows の共通 IO を実行します。 これは、カスタムのリリース管理 PowerShell スクリプトに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-command

N/A

○

固定値 ./ManageWindowsIO.ps1。

-Action

動作

○

実行するアクションを指定します。

  • Create: 新しいフォルダーを作成します。

  • Delete: ファイルまたはフォルダーを削除します。

  • Rename: ファイルまたはフォルダーの名前を変更します。

  • Move: ファイルまたはフォルダーを移動します。

  • Attrib: ファイルまたはフォルダーの属性 (所有権を含む) を変更します。

-FileFolderName

FileFolderName

○

ファイルまたはフォルダーのパスと名前。

-DestinationName

×*

変更後の名前 (名前変更アクションの場合) または移動先のフォルダーのパスと名前 (移動アクションの場合)。名前変更と移動アクションのために必要です。

-ReadOnly

Ｘ

ファイルまたはフォルダーに対して読み取り専用属性を設定または解除できます。

  • +: フラグを設定します

  • -: フラグを解除します。

  • これ以外の値: フラグはそのままにします

-Archive

Ｘ

ファイルまたはフォルダーに対してアーカイブ属性を設定または解除できます。

  • +: フラグを設定します

  • -: フラグを解除します。

  • これ以外の値: フラグはそのままにします

-System

Ｘ

ファイルまたはフォルダーに対してシステム属性を設定または解除できます。

  • +: フラグを設定します

  • -: フラグを解除します。

  • これ以外の値: フラグはそのままにします

-Hidden

Ｘ

ファイルまたはフォルダーに対して隠し属性を設定または解除できます。

  • +: フラグを設定します

  • -: フラグを解除します。

  • これ以外の値: フラグはそのままにします

-OwnerDomain

Ｘ

ファイルまたはフォルダーの新しい所有者のドメインです。

-OwnerName

Ｘ

ファイルまたはフォルダーの新しい所有者の名前です。

Windows サービス マネージャー

このツールでは、Windows サービスを管理できます。 これは、カスタムのリリース管理 PowerShell スクリプトに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-command

N/A

○

固定値 ./ManageWindowsServices.ps1。

-Action

動作

○

実行するアクションを指定します。

  • Create: 新しいサービスを作成します。

  • Config: 既存のサービスを構成します。

  • Delete: 既存のサービスを削除します。

  • Start: サービスを開始します。

  • Stop: サービスを停止します。

  • Restart: サービスを停止および開始します。

-ServiceName

ServiceName

○

サービスの名前。

-ServerName

Ｘ

このアクションを実行するサーバーの名前。 指定しない場合、現在のサーバーが使用されます。

-BinPath

×*

サービスのバイナリのパスと名前。 Create アクションでは必須、Config アクションではオプションです。それ以外のアクションでは無視されます。

-DisplayName

Ｘ

このサービスに使用する表示名。 Create アクションと Config アクションではオプション、それ以外のアクションでは無視されます。

-Description

Ｘ

サービスに渡される説明。 Create アクションと Config アクションではオプション、それ以外のアクションでは無視されます。

-UserName

Ｘ

サービスを開始するための資格情報で使用されるユーザー名 ("ドメイン名\ユーザー名" の形式にする必要があります)。 このパラメーターを指定する場合、Password パラメーターも指定する必要があります。 このパラメーターを指定しない場合、既定で LocalSystem アカウントが使用されます。 Create アクションと Config アクションではオプション、それ以外のアクションでは無視されます。

LocalSystem に対する資格情報をリセットするには、ユーザー名として「LocalSystem」と入力し、パスワードは "" とします。

-Password

Ｘ

サービスを開始するために指定するユーザー名のパスワード。 Create アクションと Config アクションではオプション、それ以外のアクションでは無視されます。

-StartMode

Ｘ

サービスの開始モード。 既定では、サービスは Automatic モードで作成されます。 以下のいずれかを選択できます。

  • Manual: サービスは手動でのみ開始されます。

  • Automatic: コンピューターの次回の再起動で、サービスが自動的に開始されます。

  • Disabled: サービスが無効です。

Create アクションと Config アクションではオプション、それ以外のアクションでは無視されます。

DACPAC Database Deployment Agent

このツールでは、DACPAC パッケージを配置できます。 これは、SQL Server コマンド ラインのユーティリティに基づいています。 この実行可能ファイルに指定できるパラメーターは多数ありますが、これはこのツールで使用されるパラメーターの一覧です。 詳細については、SqlPackage.exe を参照してください。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

/Action:

○

固定値: Publish – パッケージの発行を指定します。

/SourceFile:

FileName

○

DACPAC の完全パス (必要な場合) とファイル名。

/TargetServerName:

ServerName

○

パッケージを発行する SQL Server の名前。

/TargetDatabaseName:

DatabaseName

○

パッケージを発行する SQL Server データベースの名前。

IIS Deployment Agent

このツールでは、IIS オブジェクトと設定を操作できます。 これは、カスタムのリリース管理実行可能ファイルに基づいています。 このツールの構成変数は、実行するアクションの種類に応じて異なります。

アプリケーション プール関連のアクション:

パラメーター

変数

必須

説明

-Action

○

実行するアクションを指定します。

  • CreateApplicationPool

  • ConfigureApplicationPool

  • DropApplicationPool

  • StartApplicationPool

  • StopApplicationPool

  • RecycleApplicationPoo

-ap

○

アプリケーション プールの名前。

-apAllow32Bit

Ｘ

アプリケーション プールに 32 ビット アプリケーションを許可する必要があるかどうかを示すフラグ。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。 有効な値は以下のものがあります。

  • 1 または True: 32 ビット アプリケーションが許可されます。

  • 0 または False: 32 ビット アプリケーションは許可されません。

-apIdentUserDomain

Ｘ

アプリケーション プールの ID に使用するユーザーのドメイン。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。 定義がなく、"IdentityUserName" が定義されている場合、ユーザーはローカル ユーザー (. .\localuser) であると見なされます。

-apIdentUserName

Ｘ

アプリケーション プールの ID に使用するユーザー名。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。 定義がない場合には、"IdentityUserDomain" および "IdentityUserPassword" が無視され、IIS の既定値 (ApplicationPoolIdentity) が使用されます。

-apIdentUserPassword

Ｘ

アプリケーション プールの ID に使用するユーザーのパスワード。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。

-apNetVers

Ｘ

アプリケーション プールに使用する .NET Framework のバージョン。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。 許可される値は、v1.0、v1.1、v2.0、v4.0 です

-apPipelineMode

Ｘ

アプリケーション プールに使用するマネージ パイプライン モード。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。 有効な値は以下のものがあります。

  • Classic

  • Integrated

-apProcessIdleTimeout

Ｘ

アプリケーション プールでプロセスがアイドル状態になっていることができる時間 (分単位)。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。

-apRecycleKbMemory

Ｘ

アプリケーション プールのリサイクルまでに使用できるメモリの最大量 (KB 単位)。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。

-apRecycleMinutes

Ｘ

アプリケーション プールのリサイクルまでの固定時間 (分単位)。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。

- apRecycleSpecificTime

Ｘ

アプリケーション プールがリサイクルされる時刻。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。 形式は HH:MM にする必要があります (23:58、01:23 など)。

-apStartMode

Ｘ

アプリケーション プールに使用する開始モード。 このパラメーターは、IIS 8.0 および 8.5 でのみ使用できます。 有効な値は以下のものがあります。

  • OnDemand

  • AlwaysRunning

-AutoStart

Ｘ

アプリケーション プールを自動的に開始する必要があるかどうかを示すフラグ。 このパラメーターは、IIS 7.0、7.5、8.0、および 8.5 でのみ使用できます。 有効な値は以下のものがあります。

  • 1 または True: Windows を起動すると、アプリケーション プールを自動で開始します。

  • 0 または False: Windows を起動しても、アプリケーション プールは自動的に開始しません。

-log

Ｘ

Web サイト関連のアクション:

パラメーター

変数

必須

説明

-Action

○

実行するアクションを指定します。

  • CreateWebSite

  • ConfigureWebSite

  • DropWebSite

  • StartWebSite

  • StopWebSite

  • RestartWebSite

-sn

○

Web サイト名。

-port

×*

Web サイトのポート番号。 Create アクションでは必須、Configure アクションではオプションです。

-pd

×*

アプリケーションを発行した場所にルーティングする完全パス。 Create アクションでは必須、Configure アクションではオプションです。

メモメモ
パスの末尾にスラッシュがないことを確認します。

-ap

Ｘ

アプリケーション プールの名前。 作成時に定義しない場合、既定のアプリケーション プールが使用されます。 Create アクションと Configure アクションでオプションです。

-EnablePreload

Ｘ

IIS 7.0、7.5、8.0、および 8.5 で使用できます。 Web サイトをプリロードする必要があるかどうかを示すフラグ。 Create アクションと Configure アクションでオプションです。 次の値を指定できます。

  • 1 または True: プリロードが有効です。

  • 0 または False: プリロードが無効です。

-AutoStart

Ｘ

IIS 7.0、7.5、8.0、および 8.5 で使用できます。 Web サイトが自動的に開始する必要があるかどうかを示すフラグ。 Create アクションと Configure アクションでオプションです。 次の値を指定できます。

  • 1 または True: 自動的に開始します。

  • 0 または False: 自動的に開始しません。

-log

Ｘ

指定された名前を持つログ ファイルが物理ディレクトリに生成されます。

Web アプリケーション関連のアクション:

パラメーター

変数

必須

説明

-Action

○

実行するアクションを指定します。

  • CreateWebApplication

  • ConfigureWebApplication

  • DropWebApplication

-ws

○

作成するアプリケーションの名前。

-pd

×*

アプリケーションを発行した場所にルーティングする完全パス。 Create アクションでは必須、Configure アクションではオプションです。

-sn

Ｘ

Web サイト名。 指定しない場合、新しいアプリケーションの作成時に既定の Web サイトが使用されます。 Create アクションと Configure アクションでオプションです。

-ap

Ｘ

アプリケーション プールの名前。 作成時に定義しない場合、既定のアプリケーション プールが使用されます。 Create アクションと Configure アクションでオプションです。

-EnablePreload

Ｘ

IIS 7.0、7.5、8.0、および 8.5 で使用できます。 Web サイトをプリロードする必要があるかどうかを示すフラグ。 Create アクションと Configure アクションでオプションです。 次の値を指定できます。

  • 1 または True: プリロードが有効です。

  • 0 または False: プリロードが無効です。

-log

Ｘ

この名前を持つログ ファイルが物理ディレクトリに生成されます。

仮想ディレクトリ関連のアクション:

パラメーター

変数

必須

説明

-Action

○

実行するアクションを指定します。

  • CreateVirtualDirectory

  • ConfigureVirtualDirectory

  • DropVirtualDirectory

-vd

○

仮想ディレクトリの名前。

-pd

×*

仮想ディレクトリの完全パス。 Create アクションでは必須、Configure アクションではオプションです。

-sn

Ｘ

Web サイト名。 指定しない場合、新しいアプリケーションの作成時に既定の Web サイトが使用されます。 Create アクションと Configure アクションでオプションです。

-ws

Ｘ

Web アプリケーションの名前。 指定しない場合、新しい仮想ディレクトリの作成時にルートの Web アプリケーションが使用されます。 Create アクションと Configure アクションでオプションです。

-log

Ｘ

この名前を持つログ ファイルが物理ディレクトリに生成されます。

Microsoft Azure VM マネージャー

このツールでは、Microsoft Azure の VM を管理できます。 これは、カスタムのリリース管理 PowerShell スクリプトに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-command

N/A

○

固定値 ./ControlAzureVM.ps1。

-Command

○

実行するアクションを指定します。

  • Start: VM を開始します。

  • Stop: VM を停止します。

-ServiceName

ServiceName

○

VM が存在する Microsoft Azure サービスの名前。

-Name

名前

○

Microsoft Azure VM の名前。

XBAP 配置機能

このツールでは、XBAP アプリケーションを配置できます。 これは、カスタムのリリース管理実行可能ファイルに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-pn

ProjectName

○

配置する XBAP プロジェクトの名前。

-d

Installation Path

○

XBAP アプリケーションのインストール パス。

-ml

Ｘ

mage ユーティリティの実行可能ファイルへの完全パス。 これを定義しない場合、ツールでリソースとして提供されている実行可能ファイルが使用されます。

-pl

Ｘ

配置する XBAP プロジェクトが置かれている場所の完全パス。 これを指定しない場合、ツールが実行されるパッケージの場所が使用されます。

-url

Ｘ

これを指定すると、setup.exe ファイルの URL が指定された URL に置き換えられます。

-cf

Ｘ

指定すると、マニフェストの更新時にこれが証明書の名前として使用されます。

-pwd

Ｘ

指定すると、マニフェストの更新時にこれが証明書のパスワードとして使用されます。

-log

Ｘ

この名前を持つログ ファイルが物理ディレクトリに生成されます。

Microsoft テスト マネージャー (MTM) コマンド ライン ユーティリティ

このツールでは、MTM (Microsoft テスト マネージャー) で実行される自動テストを作成し、起動できます。 これは、カスタムのリリース管理 PowerShell スクリプトに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-command

N/A

○

固定値 ./TcmExec.ps1。

-Title

TestRunTitle

○

テスト実行を作成する際に使用される名前。

-PlanId

PlanId

○

テストを実行する際に使用されるテスト計画の識別子 (Test Manager で定義されている一意の ID)。

-SuiteId

SuiteId

○

実行するテスト スイートの識別子 (Test Manager で定義されている一意の ID)。

-ConfigId

ConfigId

○

テストを実行する際に使用されるテスト構成の識別子 (テスト マネージャーで定義されている一意の識別子)。

-Collection

TFSCollection

○

自動テストを実行する Team Foundation Server のコレクション URL。

-TeamProject

TeamProject

○

自動テストが構成されているチーム プロジェクトの名前。

-TestEnvironment

TestEnvironment

○

テストが実行されるテスト環境 (テスト環境は対応するテスト コントローラーに関連付けられます)。

-BuildDirectory

BuildDirectory

×*

自動テストの場所。 MTM 2010 では、このパラメーターが必須です。 MTM 2012 と 2013 でもこのパラメーターはサポートされますが、BuildDefinition パラメーターと BuildNumber パラメーターを使用することをお勧めします。

-BuildDefinition

×*

自動テストが含まれているビルド定義を指定できます。 このパラメーターを使用できるのは MTM 2012 のみです。 このパラメーターを定義する場合、BuildNumber パラメーターも指定する必要があります。 指定しない場合、テスト実行の詳細に表示される build フィールドがテスト実行に影響されなくなります。

-BuildNumber

×*

格納場所に自動テストが含まれるビルド番号を指定できます。 このパラメーターを使用できるのは MTM 2012 のみです。 このパラメーターを定義する場合、BuildDefinition パラメーターも指定する必要があります。 指定しない場合、テスト実行の詳細に表示される build フィールドがテスト実行に影響されなくなります。

-SettingsName

Ｘ

テスト実行に使用する設定を指定できます。 指定しない場合、既定のテスト設定が使用されます。

-TestRunWaitDelay

Ｘ

テスト コントローラーを呼び出す間隔 (遅延時間) を秒数で指定できます。 テスト結果を処理する前にテスト実行を完了するために、これを指定する必要があります。 指定しない場合、既定で 10 秒に設定されます。

-InconclusiveFailsTests

N/A

Ｘ

このフラグを設定すると、結果が不確定のテストが存在する場合に配置が失敗します。 既定では、結果が不確定のテストによって配置が失敗することはありません。

-RemoveIncludeParameter

N/A

Ｘ

このフラグを設定すると、/include パラメーターがテスト作成コマンドに追加されません。 つまり、Active 以外の状態であるテストがテスト実行に含まれなくなります。

配置するアプリケーションと同じビルド プロセスに自動テストが含まれている場合、変数値としてメタデータを使用することができます。これは、リリース時に自動的に置き換えられます。 次の表に、現時点で構成変数と共に使用できるメタデータを示します。

変数

変数の値のメタデータ

BuildDirectory

$(PackageLocation)

BuildNumber

$(BuildNumber)

BuildDefinition

$(BuildDefinition)

TFSCollection

$(TFSUrlWithCollection)

TeamProject

$(TeamProject)

INI ファイル マネージャー

このツールでは、.ini ファイルの内容を変更し、指定があれば新しい .ini ファイルを作成することができます。 これは、カスタムのリリース管理実行可能ファイルに基づいています。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-Action

○

実行するアクションを指定します。

  • ModifySection

  • RemoveSection

  • CreateKeyValue

  • ModifyKeyValue

  • RemoveKeyValue

-INIFile

INIFileName

○

.ini ファイルの名前とパス (必要な場合)。

-SectionName

SectionName

Ｘ

適用されるセクション名。 これを指定しない場合、ルート セクションが考慮されます (最初のセクションの前の、ファイルの冒頭部にあるすべてのキーがルートに存在すると見なされます)。

-NewSectionName

Ｘ

新しいセクション名。 これを指定しない場合、ルート セクションが考慮されます (最初のセクションの前の、ファイルの冒頭部にあるすべてのキーがルートに存在すると見なされます)。 ModifySection アクションでは必須です。

-KeyName

Ｘ

適用されるキー名。 CreateKeyValue、ModifyKeyValue、および RemoveKeyValue で必須です。

-KeyValue

Ｘ

キーに使用する値。 ModifyKeyValue アクションを使用し、このパラメーターを指定せずに NewKeyName を指定した場合、実際の値が使用されます。 この値を指定せず、NewKeyName も指定しなかった場合、値が空になります。

-NewKeyName

Ｘ

キーに付ける新しい名前。 ModifyKeyValue アクションでのみ使用されます。

-CreateFileIfNotExists

Ｘ

ファイルが存在しない場合にそのファイルを作成するように指定します。

Windows プロセス

このツールでは、Windows プロセスを強制終了することができます。 このツールの構成変数は以下のとおりです。

パラメーター

変数

必須

説明

-command

N/A

○

固定値 ./WindowsProcess.ps1。

-ProcessName

○

強制終了する Windows プロセスの名前。

-UserName

Ｘ

プロセスを実行しているユーザー アカウント。 指定がない場合には、すべてのユーザーのプロセスが強制終了となります。

-IsKillProcessTree

Ｘ

プロセス ツリーを強制終了する必要があるかどうかを示すフラグ。有効な値は以下のとおりです。

  • 1: プロセス ツリーを強制終了します。

  • 0 または入力なし: プロセス ツリーを強制終了しません。