Aufgabe "Get"
Aktualisiert: November 2007
Die Aufgabe Get ruft unter Verwendung von spezifischen Optionen eine schreibgeschützte Kopie der Dateien und Ordner eines Arbeitsbereichs ab.
Parameter
Parameter |
Beschreibung |
|---|---|
BuildUri |
Gibt den Build-URI an. |
Workspace |
Gibt den Namen des Arbeitsbereichs an. |
Version |
Gibt die versionspec für die Datei an. Standardmäßig wird die versionspec T (die letzte Version) verwendet. Legen Sie die GetVersion-Eigenschaft in der Datei TFSBuild.proj fest, um eine andere Version abzurufen. Dieses Verhalten entspricht der /version-Option des tf.exe get-Befehls. Weitere Informationen finden Sie unter Befehl Get. |
Filespec |
Gibt die Elemente im Arbeitsbereich an. Standardmäßig ruft Team Foundation Build alle Elemente im Arbeitsbereich ab, der von der WorkspaceName-Eigenschaft angegeben wird. Überschreiben Sie die GetFileSpec-Eigenschaft in TFSBuild.proj, um eine bestimmte Itemspec anzugeben. Dies entspricht dem Itemspec-Parameter des tf.exe get-Befehls. |
PopulateOutput |
Standardmäßig gibt Team Foundation Build nicht die Liste der Elemente zurück, die abgerufen, ersetzt oder gelöscht wurden. Es werden auch keine von der Aufgabe Get generierten Warnungen zurückgegeben. Legen Sie die GetPopulateOutput-Eigenschaft in der Datei TFSBuld.proj auf true fest, um diese Listen verfügbar zu machen. Wenn Sie GetPopulateOutput auf true festlegen, erhalten Sie Folgendes:
|
Preview |
Gibt an, ob das Ergebnis angezeigt werden soll, ohne dass der Get-Vorgang tatsächlich ausgeführt wird. Legen Sie PreviewGet in der Datei TFSBuild.proj auf true fest, um eine Vorschau des Get-Vorgangs anzuzeigen. Dies entspricht der /preview-Option des tf.exe get-Befehls. |
Recursive |
Gibt an, ob Dateien rekursiv abgerufen werden. Legen Sie die RecursiveGet-Eigenschaft in der Datei TfsBuild.proj auf false fest, um einen nicht-rekursiven Abruf in einem Team Foundation Build-Projekt durchzuführen. Dies entspricht der /recursive-Option des tf.exe get-Befehls. |
Force |
Gibt an, ob die Dateien inkrementell abgerufen werden. Um einen inkrementellen Abruf in einer Team Foundation Build-Definition durchzuführen, legen Sie die ForceGet-Eigenschaft in der Datei TfsBuild.proj auf false fest. Entspricht der /force-Option des tf.exe get-Befehls. |
Gets |
Ausgabeparameter. Gibt die Liste von Elementen an, die von der Get-Aufgabe abgerufen wurden. |
Replaces |
Ausgabeparameter. Gibt die Liste von Elementen an, die von der Get-Aufgabe ersetzt wurden. |
Deletes |
Ausgabeparameter. Gibt die Liste von Elementen an, die von der Get-Aufgabe gelöscht wurden. |
Warnings |
Ausgabeparameter. Gibt die Liste von Warnungen an, die von der Get-Aufgabe generiert wurden. |
Hinweise
Die Get-Aufgabe ist in der Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll definiert. Die Datei Microsoft.TeamFoundation.Build.targets enthält eine Instanz der Get-Aufgabe, die von Team Foundation Build als eine Standardimplementierung für das CoreGet-Ziel verwendet wird.
Der Ordner <root>:\Programme\MSBuild\Microsoft\VisualStudio\TeamBuild auf dem Team Foundation Build-Computer enthält die Datei Microsoft.TeamFoundation.Build.targets.
Beispiel
Im folgenden Beispiel wird die Standardinstanz der Get-Aufgabe, die in der Datei Microsoft.TeamFoundation.Build.targets definiert ist, veranschaulicht.
<Get
BuildUri="$(BuildURI)"
Workspace="$(WorkspaceName)"
Version="$(GetVersion)"
Filespec="$(GetFilespec)"
PopulateOutput="$(GetPopulateOutput)"
Preview="$(PreviewGet)"
Recursive="$(RecursiveGet)"
Force="$(ForceGet)">
<Output TaskParameter="Gets" ItemName="Gets" />
<Output TaskParameter="Replaces" ItemName="Replaces" />
<Output TaskParameter="Deletes" ItemName="Deletes" />
<Output TaskParameter="Warnings" ItemName="GetWarnings" />
</Get>
Siehe auch
Aufgaben
Gewusst wie: Anpassen von Buildnummern
Konzepte
Team Foundation Build-Aufgaben