DeleteWorkspaceTask タスク

更新 : 2007 年 11 月

DeleteWorkspaceTask タスクは、前のビルドで残されたワークスペースを削除します。

パラメータ

プロパティ

説明

TeamFoundationServerUrl

Team Foundation Server の URL を指定します。たとえば、http://MyServer:8080 です。

Name

ワークスペースの名前を指定します。

DeleteLocalItems

ワークスペース マッピングに指定されているローカル項目を削除するかどうかを指定します。DeleteLocalItems を true に設定すると、ローカル項目は削除されます。DeleteLocalItems を false に設定すると、ローカル項目は削除されません。

CleanCompilationOutpuOnly プロパティと SkipInitializeWorkspace プロパティが false に設定されていると、DeleteLocalItems は true に設定されます。

CleanCompilationOutpuOnly プロパティと SkipInitializeWorkspace プロパティが true に設定されていると、DeleteLocalItems は false に設定されます。

解説

DeleteWorkspaceTask タスクは Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll で定義されています。Microsoft.TeamFoundation.Build.targets ファイルには、Team Foundation ビルドが AfterGet ターゲット用の既定の実装として使用する DeleteWorkspaceTask タスクのインスタンスが含まれています。また、ビルドの種類に対する DeleteWorkspaceTask のインスタンスを TFSBuild.proj ファイルで別途定義して、ビルド処理をカスタマイズすることもできます。

Microsoft.TeamFoundation.Build.targets ファイルは、Team Foundation ビルド コンピュータの <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild フォルダに保存されます。

使用例

次の例では、TFSBuild.proj ファイルの DeleteWorkspaceTask タスクを使用して、指定のワークスペースを削除します。

<!-- Add the UsingTask to the top of the TFsBuild.proj file, right after the schema definition-->
<UsingTask TaskName="Microsoft.TeamFounadtion.Build.Tasks.DeleteWorkspaceTask"   AssemblyFile="$(TeamBuildRefPath)\Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll" />
<!-- Add the following XML after the closing </ItemGroup>-->
<!-- and before the closing </Project>-->
</ItemGroup>
   <PropertyGroup>      <WorkspaceName>MyWorkspace</WorkspaceName>   </PropertyGroup>   <TargetName="AfterGet">      <DeleteWorkspaceTask         TeamFoundationServerUrl="http://MyTFServer.8080"         Name="$(WorkspaceName)"/>   </Target>
</Project>

次の例は、Microsoft.TeamFoundation.Build.targets ファイルで定義されている DeleteWorkspaceTask タスクの既定のインスタンスです。

<DeleteWorkspaceTask
    Condition=" '$(CleanCompilationOutputOnly)' != 'true' " 
    TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
    Name="$(WorkspaceName)"
    DeleteLocalItems="true" />

<DeleteWorkspaceTask
    Condition=" '$(CleanCompilationOutputOnly)' == 'true' "
    TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
    Name="$(WorkspaceName)"
    DeleteLocalItems="false" />

参照

処理手順

方法 : ビルド番号をカスタマイズする

概念

Team Foundation ビルドのタスク

Team Foundation ビルドの構成ファイルについて

その他の技術情報

Team Foundation ビルドのカスタマイズ

Team Foundation ビルドのターゲット、タスク、およびプロパティ