Team Foundation LabManagement-Aktivitäten

Aktualisiert: August 2010

Wenn Sie eine Lab Management-Workflowvorlage (LabDefaultTemplate.xaml) anpassen, können Sie mindestens eine der vordefinierten Lab Management-Aktivitäten verwenden. Sie können auch auf Objekte zugreifen, die vom Lab Management-Assistenten erstellt werden. Dieses Thema beschreibt die Team Foundation Lab Management-Aktivitäten und - Objekte, die verfügbar sind, wenn Sie eine Workflowvorlage anpassen, um die Anwendung zu erstellen, bereitzustellen und zu testen. Weitere Informationen zum Ausführen dieser Aktivitäten in einem benutzerdefinierten Workflows finden Sie unter Anpassen des Lab-Management-Workflows.

Dieses Thema enthält folgende Abschnitte:

1. Lab Management-Aktivitäten

2. Lab Management-Klassen

Lab Management-Aktivitäten

In der folgenden Tabelle werden die einzelnen Lab Management-Workflowaktivitäten beschrieben.

Aktivität	Beschreibung
CreateLabEnvironment	Erstellt eine neue Umgebung mithilfe einer gespeicherten Umgebung und stellt sie in der angegebenen Hostgruppe bereit.
DeleteLabEnvironment	Löscht eine Umgebung.
DeleteSnapshot	Löscht eine Momentaufnahme einer Umgebung.
ExecuteRemoteTestRun	Erstellt einen Testlauf in einer Umgebung und wartet auf dessen Fertigstellung.
GenerateEnvironmentViewerFile	Generiert eine Umgebungs-Viewer-Datei, die eine Momentaufnahmenlink-ID besitzt. Mit dieser Aktivität wird eine Verbindung mit einer Momentaufnahme der Umgebung hergestellt.
GetBuildLocationAndBuildNumber	Gibt den Buildspeicherort und die Buildnummer für ein Build-, Bereitstellungs- und Testszenario zurück.
GetLabEnvironmentInUseMarker	Gibt die Kennzeichnung "In Gebrauch" für eine Umgebung zurück.
GetLabEnvironmentSnapshotId	Ruft die ID einer Momentaufnahme einer Umgebung ab.
GetLabEnvironmentStatus	Ruft den Umgebungsstatus ab.
GetLabEnvironmentUri	Ruft den Umgebungs-URI für einen angegebenen Umgebungsnamen und den Namen eines Lab-Speicherorts ab.
InitializeAgentSpecAndEnvironmentVariables	Analysiert die Bereitstellungsskriptsdetails, die durch die Eigenschaft angegeben werden.
ResetLabEnvironmentInuseMarker	Setzt die Kennzeichnung "In Gebrauch" für eine Umgebung zurück.
RestoreLabEnvironment	Stellt die Umgebung mit der angegebenen Momentaufnahme wieder her.
RunDeploymentScript	Führt das Bereitstellungsskript aus. Bei einem Fehler wird eine Buildwarnung ausgelöst oder geschrieben (siehe Angabe in der ThrowOnError-Eigenschaft).
RunWorkflow	Fügt einen neuen Workflow auf einem Buildcontroller eines Buildservers der Warteschlange hinzu.
SaveLabEnvironment	Erstellt eine neue Umgebung und speichert sie in einer Teamprojekt-Bibliotheksfreigabe.
SetLabEnvironmentInuseMarker	Legt die Kennzeichnung "In Gebrauch" für die Umgebung fest.
SnapshotLabEnvironment	Erstellt eine Momentaufnahme einer Umgebung.
StartLabEnvironment	Startet die Umgebung.
StopLabEnvironment	Beendet die Umgebung.
WaitForTestCapabilityServices	Wartet die angegebene maximale Zeit auf die Bereitschaft der Testfunktion der Umgebung. Am Ende der Wartezeit wird bei fehlender Betriebsbereitschaft der Testfunktion eine Timeoutausnahme ausgelöst.
WaitForWorkflow	Der Typ des Workflows.
WaitForWorkflowCapabilityServices	Wartet für eine festgelegte maximale Dauer auf den Abschluss des in der Warteschlange enthaltenen Builds. Wenn der Buildworkflow nicht in der festgelegten maximalen Zeit beendet wird, wird TimeOutException ausgelöst. Mit der Aktivität wird der Status des Builds in der Warteschlange regelmäßig überprüft, um festzustellen, welche Builds fertig gestellt wurden. Dieses Intervall wird mithilfe der RefreshInterval-Eigenschaft konfiguriert.
WriteDeploymentInformation	Schreibt Bereitstellungsinformationen, die in der Buildzusammenfassung enthalten sind.

CreateLabEnvironment

Erstellt eine neue Umgebung mithilfe einer gespeicherten Umgebung und stellt sie in der angegebenen Hostgruppe bereit. Dies ist eine Aktivität mit langer Laufzeit, bei der die Erstellung der neuen Umgebung abgewartet wird. Wenn die neue Lab-Umgebung nicht erstellt werden kann, löst diese LabDeploymentProcessExceptions-Ausnahme eine Aktivität aus.

Eigenschaften

LabEnvironmentName	Der Name der neuen Umgebung. Wenn diese Eigenschaft NULL oder leer ist, wird der Name der Umgebungsvorlage verwendet.
LabEnvironmentTemplateUri	Der URI einer gespeicherten Umgebungsvorlage. Der URI der Lab-Umgebungsvorlage kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. Erforderlich.
TeamProjectHostGroupName	Hostgruppe, in der die neue Umgebung bereitgestellt wird. Wenn die angegebene Hostgruppe nicht gefunden wird, wird eine Ausnahme vom Typ "NoTeamProjectHostGroupFoundException" ausgelöst. Erforderlich.

Zurück nach oben

DeleteLabEnvironment

Löscht eine Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der die Löschung der Umgebung abgewartet wird. Wenn das Löschen der Umgebung fehlschlägt, löst diese Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.

Eigenschaften

LabEnvironmentUri

Der URI der zu löschenden Umgebung. Der URI der Lab-Umgebung kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. Erforderlich.

Zurück nach oben

DeleteSnapshot

Löscht eine Momentaufnahme einer Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der die Löschung der Momentaufnahme abgewartet wird. Wenn das Löschen der Momentaufnahme fehlschlägt, löst diese Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.

Eigenschaften

LabEnvironmentUri	Der URI der Lab-Umgebung, deren Momentaufnahme gelöscht wird. Der URI der Lab-Umgebung kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. Erforderlich.
SnapshotId	ID der zu löschenden Momentaufnahme. Die ID der Momentaufnahme kann mithilfe der GetLabEnvironmentSnapshotId-Aktivität abgerufen werden. Erforderlich.

Zurück nach oben

ExecuteRemoteTestRun

Erstellt einen Testlauf in einer Umgebung und wartet auf dessen Fertigstellung. Dies ist eine Aktivität mit langer Laufzeit, bei der auf die Fertigstellung des Testlaufs oder auf ein Timeout gewartet wird. Sie können das Timeout mithilfe der MaxWaitTime-Eigenschaft festlegen. Mit dieser Aktivität wird der Status des Testlaufs regelmäßig überprüft, um festzustellen, welche Testläufe fertig gestellt werden. Dieses Intervall kann mithilfe der RefreshInterval-Eigenschaft konfiguriert werden. Mit der MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion-Eigenschaft kann angegeben werden, wie oft Team Foundation Server-Fehler ignoriert werden sollen, wenn der Status des Testlaufs überprüft wird.

Rückgabewert

Ein TestRunStatistics-Objekt, das die Details des Testlaufs speichert.

Eigenschaften

BuildNumber	Buildnummer zur Ausführung von Tests.
LabEnvironmentUri	Der URI der Umgebung, in der Testfälle ausgeführt werden. Der URI der Umgebung kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden.
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	Die maximale Anzahl aufeinander folgender Fehler, die ignoriert werden sollen, während die Aktivität auf die Ausführung der Tests wartet. Der Standardwert dieser Eigenschaft ist 3.
MaxWaitTime	Ein Element vom Typ TimeSpan, in dem die maximale Wartezeit für die Fertigstellung des Testlaufs angegeben wird. Am Ende einer festgelegten Frist wird eine Timeoutausnahme ausgelöst. Der Standardwert ist 0 (null). Dies bedeutet, dass die Wartezeit der Aktivität unbegrenzt ist.
RefreshInterval	Ein Element vom Typ TimeSpan, in dem das Intervall angegeben ist, nach dem der Status des Testlaufs aktualisiert wird. Der Standardwert dieses Intervalls ist 60 Sekunden.
TestDirectory	Pfad zu den ausführbaren Testdateien.
TestEnvironment	Name der Testumgebung, in der die Testfälle ausgeführt werden.
TestParameters	Ein RunTestDetails-Objekt, mit dem Testparameter wie Testplan, Testsammlung, Testeinstellungen und die Testkonfiguration angegeben werden. Erforderlich.
Titel	Der Name des Testlaufs. Erforderlich.

Zurück nach oben

GenerateEnvironmentViewerFile

Generiert eine Umgebungs-Viewer-Datei, die die ID des Momentaufnahmenlinks enthält. Mit dieser Aktivität wird eine Verbindung mit einer Momentaufnahme der Umgebung hergestellt. Der Name der Umgebungs-Viewer-Datei ist der Name der Momentaufnahme ohne die folgenden Sonderzeichen: @"\[\`~\!@\#$%^&\*()+=\[{\\\]}|\\\\;:',/?\]" + "\"".

Eigenschaften

FilePath	UNC-Pfad, in dem die Umgebungs-Viewer-Datei gespeichert wird. Das Builddienstkonto muss über eine Schreibberechtigung für den Pfad verfügen. Erforderlich.
LabEnvironmentUri	Der URI der Umgebung. Der URI der Umgebung kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. Erforderlich.
SnapshotId	Die ID der Momentaufnahme. Die ID der Momentaufnahme kann mithilfe der GetLabEnvironmentSnapshotId-Aktivität abgerufen werden. Wenn die Momentaufnahme ungültig ist, wird eine Ausnahme vom Typ "InvalidSnapshotExceptions" ausgelöst. Erforderlich.

Zurück nach oben

GetBuildLocationAndBuildNumber

Gibt den Buildspeicherort und die Buildnummer für ein Build-, Bereitstellungs- und Testszenario zurück. Wenn "Teambuild" ausgewählt wird und der URI des Builds NULL ist, wird der letzte gültige Build ausgewählt, und Details werden zurückgegeben. Wenn kein gültiger Build gefunden wird, wird eine Ausnahme vom Typ "System.ArgumentException" ausgelöst. Wenn "Teambuild" nicht ausgewählt wird, wird nur der vom Benutzer angegebene Speicherort des Builds zurückgegeben.

Rückgabewert

Eine String, mit der der Speicherort des Builds angegeben wird.

Eigenschaften

BuildDetails	Ein Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails-Objekt, das buildbezogene Informationen im Build-, Bereitstellungs- und Testszenario beinhaltet.
BuildNumber	Die Buildnummer des ausgewählten Builds. Dies ist ein out-Argument. Für Builds vom Typ "Teambuild" ist der Wert NULL.
SelectedBuild	Buildinformationen zum Buildserver. Dies ist ein out-Argument. Für Builds vom Typ "Teambuild" ist der Wert NULL.

Zurück nach oben

GetLabEnvironmentInUseMarker

Ruft die Kennzeichnung "In Gebrauch" für eine Umgebung ab.

Rückgabewert

Eine LabEnvironmentInUseMarker zur Angabe der Details des Umgebungsmarkers.

Eigenschaften

LabEnvironmentUri

Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.

Zurück nach oben

GetLabEnvironmentSnapshotId

Ruft die ID einer Momentaufnahme einer Umgebung ab. Wenn keine Momentaufnahme mit dem angegebenen Namen gefunden wird, wird eine Ausnahme vom Typ "NoSnapshotFoundException" ausgelöst.

Rückgabewert

Ein Int64 zur Angabe des Bezeichners der Momentaufnahme.

Eigenschaften

LabEnvironmentUri	Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.
SnapshotName	Der Snapshotname. Erforderlich.

Zurück nach oben

GetLabEnvironmentStatus

Ruft den Status der Umgebung ab.

Rückgabewert

Ein LabEnvironmentState-Enumerationswert, der den aktuellen Zustand der Umgebung angibt.

Eigenschaften

LabEnvironmentUri

Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.

Zurück nach oben

GetLabEnvironmentUri

Ruft den Umgebungs-URI für einen angegebenen Umgebungsnamen und den Namen eines Lab-Speicherorts ab. Der Lab-Speicherort kann entweder eine Hostgruppe oder eine Bibliotheksfreigabe sein. Wenn die Umgebung nicht gefunden wird, wird eine Ausnahme vom Typ "LabEnvironmentNotFoundException" ausgelöst.

Rückgabewert

Eine String, mit der der URI der Umgebung angegeben wird.

Eigenschaften

LabEnvironmentName	Der Name der Umgebung. Erforderlich.
ProjectName	Name des Teamprojekts Wenn dieser Eigenschaftswert NULL ist oder nicht angegeben wird, wird das aktuelle Projekt des Builds verwendet.
TeamProjectLabLocationName	Der Name des Lab-Speicherorts. Dabei kann es sich entweder um einen Hostgruppennamen oder einen Bibliotheksfreigabenamen handeln. Wenn der Speicherort der Lab-Umgebung nicht gefunden wird, wird eine Ausnahme vom Typ "NoLabLocationFoundException" ausgelöst. Erforderlich.

Zurück nach oben

InitializeAgentSpecAndEnvironmentVariables

Initialisiert die Argumente, die für die RunDeploymentScript-Aktivität erforderlich sind. InitializeAgentSpecAndEnvironmentVariables extrahiert die Eigenschaften der virtuellen Computer in der Umgebung, die für die Bestimmung des Bereitstellungsskripts auf den Computern erforderlich sind.

Rückgabewert

Ein ScriptDetails-Objekt, mit dem die Skriptdetails gespeichert werden, die für die Bereitstellung erforderlich sind.

Eigenschaften

BuildLocation	Der Pfad zum Speicherort des Builds. Dient zur Erweiterung des Makros $ (BuildLocation). Erforderlich.
DeploymentScriptDetails	Bereitstellungsdetails im Format "Name des Lab-Systems | Skriptargumente | Arbeitsverzeichnis". Erforderlich.
LabEnvironmentUri	Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.

Zurück nach oben

ResetLabEnvironmentInuseMarker

Setzt die Kennzeichnung "In Gebrauch" für eine Umgebung zurück.

Eigenschaften

LabEnvironmentUri

Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.

Zurück nach oben

RestoreLabEnvironment

Stellt die Umgebung mit der angegebenen Momentaufnahme wieder her. Wenn die Momentaufnahme ungültig ist, wird eine Ausnahme vom Typ "InvalidSnapshotException" ausgelöst.

Eigenschaften

LabEnvironmentUri	Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.
SnapshotId	Die ID der Momentaufnahme, in der die Umgebung wiederhergestellt werden soll. Die ID der Momentaufnahme kann mithilfe der GetLabEnvironmentSnapshotId-Aktivität abgerufen werden. Erforderlich.

Zurück nach oben

RunDeploymentScript

Führt das Bereitstellungsskript aus. Wenn das Skript fehlschlägt, wird eine Buildwarnung ausgelöst oder geschrieben, wie in der ThrowOnError-Eigenschaft angegeben.

Rückgabewert

Ein BuildStatus-Enumerationswert, der den Status des Bereitstellungsvorgangs angibt.

Eigenschaften

MaximumAttemptsForNetUse	Maximale Anzahl der Versuche für das Hinzufügen von Netzauslastung.
ScriptDetails	Ein Skriptdetailobjekt für ein Lab-System. Erforderlich.
SharedLocationForNetUse	Speicherort, der für das Lab-Builddienstkonto zugänglich sein sollte.
ThrowOnError	Hiermit wird angegeben, ob wegen des Fehlers eine Ausnahme ausgelöst werden soll. Der Standardwert ist "true".

Zurück nach oben

RunWorkflow

Fügt einen neuen Workflow auf einem Buildcontroller eines Buildservers der Warteschlange hinzu. Es gibt zwei Möglichkeiten zur Angabe des Buildcontrollers, auf dem der Build der Warteschlange hinzugefügt werden muss:

1. Verwenden Sie die LabEnvironmentUri-Eigenschaft. Wenn diese Umgebung für Workflowintegration konfiguriert wird, wird der Buildcontroller der Umgebung für den Warteschlangenworkflow verwendet. Andernfalls wird eine Ausnahme vom Typ "LabDeploymentProcessException" ausgelöst.

2. Mit der BuildControler-Eigenschaft wird der Buildcontroller angegeben.

Rückgabewert

Ein Int32, mit dem die ID des Builds angegeben wird, der sich in der Warteschlange befindet.

Eigenschaften

BuildController	Der Name des Buildcontrollers. Wenn diese Eigenschaft und der LabEnvironmentUri-Eigenschaftswert NULL oder nicht angegeben sind, wird der aktuelle Buildcontroller zum Hinzufügen des Builds zur Warteschlange verwendet.
BuildDefinition	Die Definition des der Warteschlange hinzuzufügenden Builds. Erforderlich.
LabEnvironmentUri	Der URI der Umgebung mit Workflowfunktionen. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.
ProjectName	Name des Teamprojekts Wenn diese Eigenschaft NULL ist oder nicht angegeben wird, wird das aktuelle Projekt des Builds verwendet.

Zurück nach oben

SaveLabEnvironment

Erstellt eine neue Umgebung und speichert sie in einer Teamprojekt-Bibliotheksfreigabe. Dies ist eine Aktivität mit langer Laufzeit, bei der das Speichern der Umgebung abgewartet wird. Wenn bei der Erstellung der neuen Umgebung ein Fehler auftritt, wird eine Ausnahme vom Typ "LabDeploymentProcessException" ausgelöst.

Rückgabewert

Eine String, mit der die URL der neuen Umgebung angegeben wird.

Eigenschaften

LabEnvironmentName	Der Name der gespeicherten Umgebung. Wenn diese Eigenschaft NULL oder leer ist, wird der Name der Umgebung verwendet.
LabEnvironmentUri	Der URI der zu speichernden Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich.
TeamProjectLibraryShareName	Die Bibliotheksfreigabe, in der die Umgebung gespeichert wird. Wenn die angegebene Bibliotheksfreigabe nicht gefunden wird, wird eine Ausnahme vom Typ "NoTeamProjectLibraryShareFoundException" ausgelöst. Erforderlich.

Zurück nach oben

SetLabEnvironmentInuseMarker

Legt die Kennzeichnung "In Gebrauch" für die Umgebung fest.

Eigenschaften

Kommentar	Bei Festlegung des Markers wird ein Kommentar geschrieben.
LabEnvironmentUri	Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.

Zurück nach oben

SnapshotLabEnvironment

Erstellt eine Momentaufnahme einer Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der die Erstellung der Momentaufnahme der Umgebung abgewartet wird. Wenn das Löschen der Momentaufnahme fehlschlägt, löst diese Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.

Rückgabewert

Eine Int64, die die ID der Momentaufnahme angibt.

Eigenschaften

LabEnvironmentUri	Der URI der Umgebung, deren Momentaufnahme erstellt werden muss. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.
SnapshotChainId	Gibt die ID der Momentaufnahmenkette zurück.
SnapshotName	Der Name der Momentaufnahme, die erstellt werden muss. Wenn die Eigenschaft NULL ist, wird der aktuelle DateTime-Wert als Name der Momentaufnahme verwendet.

Zurück nach oben

StartLabEnvironment

Startet die Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der der Start der Umgebung abgewartet wird. Wenn der Start der Umgebung fehlschlägt, löst die Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.

Eigenschaften

LabEnvironmentUri

Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.

Zurück nach oben

StopLabEnvironment

Beendet die Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der das Beenden der Umgebung abgewartet wird. Wenn das Beenden der Umgebung fehlschlägt, löst die Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.

Eigenschaften

LabEnvironmentUri

Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.

Zurück nach oben

WaitForTestCapabilityServices

Wartet die angegebene maximale Zeit auf die Bereitschaft der Testfunktion der Umgebung. Falls die Testfunktion am Ende der Wartezeit nicht bereit ist, wird eine Timeoutausnahme ausgelöst. Wenn die RepairCapabilityBeforeWaitBegins-Eigenschaft festgelegt wird, wird die Reparaturfunktion aufgerufen, bevor die Funktion bereit ist. Die maximale Wartezeit kann mit der MaxWaitTime-Eigenschaft konfiguriert werden.

Eigenschaften

LabEnvironmentUri	Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.
MaxWaitTime	Ein System.TimeSpan-Objekt, mit dem die maximale Wartezeit für die Bereitstellung der Funktion angegeben wird. Am Ende einer festgelegten Frist wird eine Timeoutausnahme ausgelöst. Der Standardwert ist 0 (null), d. h. unbegrenzte Wartezeit.
RepairCapabilityBeforeWaitBegins	Wenn dieser Wert "true" ist, wird vor Beginn der Wartephase versucht, die Funktion zu reparieren.

Zurück nach oben

WaitForWorkflow

Wartet für eine festgelegte maximale Dauer auf den Abschluss des in der Warteschlange enthaltenen Builds. Wenn der Buildworkflow nicht in der festgelegten maximalen Zeit beendet wird, wird TimeOutException ausgelöst. Mit der Aktivität wird der Status des Builds in der Warteschlange regelmäßig überprüft, um festzustellen, welche Builds fertig gestellt wurden. Dieses Intervall wird mithilfe der RefreshInterval-Eigenschaft konfiguriert.

Rückgabewert

Ein BuildStatus-Enumerationswert, der den Status des Workflows angibt.

Eigenschaften

AllowPartiallySucceededBuild	Wenn der Wert "true" ist, wird eine teilweise erfolgreiche Ausführung als erfolgreich eingestuft.
BuildDetails	Ein Microsoft.TeamFoundation.Build.Client.IBuildDetail-Objekt, das Details zum in der Warteschlange befindlichen Build auf dem Buildserver enthält. Dies ist ein out-Argument.
LabWorkflowType	Der Typ des Workflows.
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	Maximale Anzahl aufeinander folgender Fehler, die ignoriert werden sollen, während die Fertigstellung des Workflows abgewartet wird. Der Standardwert hier ist 3. Diese Eigenschaft kann verwendet werden, um die Stabilität des Workflows zu erhöhen.
MaxWaitTime	Ein System.TimeSpan-Objekt, mit dem die maximale Wartezeit für die Fertigstellung des Workflows angegeben wird. Am Ende einer festgelegten Frist wird eine Timeoutausnahme ausgelöst. Der Standardwert ist 0 (null), d. h., die Wartezeit ist unbegrenzt.
QueueBuildId	Die ID des in der Warteschlange enthaltenen Builds. Erforderlich.
RefreshInterval	Ein System.TimeSpan-Objekt, das das Intervall angibt, nach dem der Status des Workflows aktualisiert wird. Der Standardwert dieses Intervalls ist 60 Sekunden.
ThrowOnError	Wenn der Wert "true" ist, wird bei einem Buildfehler eine Ausnahme ausgelöst.

Zurück nach oben

WaitForWorkflowCapabilityServices

Wartet die angegebene Dauer auf die Bereitschaft der Workflowfunktion für die Umgebung. Falls die Workflowfunktion am Ende der Wartezeit nicht bereit ist, wird eine Timeoutausnahme ausgelöst. Wenn die RepairCapabilityBeforeWaitBegins-Eigenschaft festgelegt wird, wird die Reparaturfunktion aufgerufen, bevor die Funktion bereit ist. Die maximale Wartezeit kann mit der MaxWaitTime-Eigenschaft konfiguriert werden.

Eigenschaften

LabEnvironmentUri	Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der Umgebungs-URI abgerufen. Erforderlich.
MaxWaitTime	Ein System.TimeSpan-Objekt, mit dem die maximale Wartezeit für die Bereitstellung der Funktion angegeben wird. Am Ende einer festgelegten Frist wird eine Timeoutausnahme ausgelöst. Der Standardwert ist 0 (null), d. h., die Wartezeit ist unbegrenzt.
RepairCapabilityBeforeWaitBegins	Wenn dieser Wert "true" ist, wird vor Beginn der Wartephase versucht, die Funktion zu reparieren.
WaitForComputerNames	Wenn dieser Wert "true" ist, wird gewartet, bis die Computernamen aller virtuellen Computer der Umgebung verfügbar sind.

Zurück nach oben

WriteDeploymentInformation

Schreibt Bereitstellungsinformationen, die in der Buildzusammenfassung enthalten sind. Der Abschnitt mit den Bereitstellungsinformationen enthält drei Unterabschnitte: Build, Bereitstellung und Test. Sie können einem bestimmten Unterabschnitt Bereitstellungsinformationen hinzufügen, indem Sie die DeploymentInformationType-Eigenschaft verwenden. Links können den Bereitstellungsinformationen mithilfe der URL-Eigenschaft hinzugefügt werden.

Eigenschaften

Nachricht	In der Zusammenfassung anzuzeigende Meldung. Erforderlich.
Url	Optionale URL oder optionaler Link, der der Meldung hinzufügt werden soll.
DeploymentInformationType	Gibt den Unterabschnitt der Bereitstellungsinformationen für diese Informationsmeldung an. Verwenden Sie einen der folgenden Werte: Build Bereitstellung Test

Zurück nach oben

Lab Management-Klassen

In der folgenden Tabelle werden die Lab Management-Klassen zusammengefasst, die Sie im Workflow-Designer verwenden können, um einen Build-, Bereitstellungs- und Testprozess anzupassen. Die Klassen sind Teil des Microsoft.TeamFoundation.Lab.Workflow.Activities-Namespace.

Objekt	Beschreibung
LabWorkflowDetails	Die LabWorkflowDetails-Klasse enthält die Konfigurationsdaten vom Assistenten für Lab-Workflowparameter. Das LabWorkflowDetails-Objekt enthält Objekte vom Typ "BuildDetails", "RunTestDetails" und "ScriptDetails".
BuildDetails	Speichert die Builddetails für ein Build-, Bereitstellungs- und Testszenario.
DeploymentDetails	Speichert die Details der Testparameter, die erforderlich sind, um den automatisierten Testlauf im Build-, Bereitstellungs- und Testworkflow zu erstellen.
LabEnvironmentDetails	Speichert die Informationen, die für die Identifizierung der Lab-Umgebung im Build-, Bereitstellungs- und Testszenario erforderlich sind.
LabEnvironmentInUseMarker	Speichert Details des Markers "In Gebrauch" einer Umgebung.
LabEnvironmentState	Gibt den aktuellen Zustand der Umgebung an.
RunTestDetails	Speichert die Testparameterdetails, die zum Erstellen des automatisierten Testlaufs erforderlich sind.
ScriptDetails	Speichert die Details des Bereitstellungsskripts die für Build-, Bereitstellungs- und Testszenarien erforderlich sind.
ScriptDetails	Speichert Details eines Testlaufs.

LabWorkflowDetails

Die LabWorkflowDetails-Klasse enthält die Konfigurationsdaten vom Assistenten für Lab-Workflowparameter. Im LabDefaultTemplate ist das LabWorkflowDetails-Objekt eines Workflows im LabWorkflowParameters-Argument enthalten. Die LabWorkflowDetails-Klasse enthält die folgenden Eigenschaften:

BuildDetails	Ein BuildDetails-Objekt, das vom Workflow-Assistenten erstellt wird und das die Builddetails für Build-, Bereitstellungs- und Testszenarien speichert.
DeploymentDetails	Ein LabEnvironmentDetails-Objekt, das vom Workflow-Assistenten erstellt wird und das die Informationen speichert, die für die Bereitstellung eines Builds in Build-, Bereitstellungs- und Testszenarien erforderlich sind.
EnvironmentDetails	Ein LabEnvironmentDetails-Objekt, das vom Workflow-Assistenten erstellt wird und das die Informationen speichert, mit denen die Umgebung für Build-, Bereitstellungs- und Testszenarien identifiziert wird.
TestParameters	Ein RunTestDetails-Objekt, das vom Workflow-Assistenten erstellt wird und das die Testparameterdetails speichert, die zum Erstellen des automatisierten Testlaufs erforderlich sind.

BuildDetails

Mit BuildDetails werden die Builddetails für Build-, Bereitstellungs- und Testszenarien gespeichert.

Eigenschaften

IsTeamSystemBuild	Ein Boolean, der angibt, ob der verwendete Build vom Typ "Teambuild" ist.
BuildDefinitionUri	Ein Uri, der den URI der Builddefinition angibt.
BuildDefinitionName	Eine String, die den Namen der Builddefinition angibt
QueueNewBuild	Ein Boolean, der angibt, ob der neue Build in die Warteschlange gestellt werden muss.
BuildUri	Ein Uri, der den URI des Builds angibt, falls der Build vom Typ "Teambuild" ist
CustomBuildPath	Eine String, die den Pfad zum Build angibt, falls der Build nicht vom Typ "Teambuild" ist.
Konfiguration

Zurück nach oben

DeploymentDetails

DeploymentDetails speichert die Details der Testparameter, die erforderlich sind, um den automatisierten Testlauf im Build-, Bereitstellungs- und Testworkflow zu erstellen. Sie können auf das DeploymentDetails-Objekt, das vom Lab Management-Assistenten erstellt wird, mit der DeploymentDetails-Eigenschaft des LabWorkflowParameters Argument-Arguments zugreifen.

Eigenschaften

PostDeploymentSnapshotPath	Eine String, die den Pfad zum Speichern der Momentaufnahmen nach der Bereitstellung beinhaltet.
PostDeploymentSnapshotName	Eine String, die den Namen der Momentaufnahme angibt, die nach der Bereitstellung erstellt wird.
TakePostDeploymentSnapshot	Ein Boolean, der angibt, ob eine Momentaufnahme nach der Bereitstellung benötigt wird.
Skripts	Ein StringList-Objekt, das eine Liste von virtuellen Computern mit entsprechenden Bereitstellungsskripts enthält.
DeploymentNeeded	Ein Boolean, der angibt, ob die Bereitstellung ausgeführt werden muss.

Zurück nach oben

LabEnvironmentDetails

Mit einem LabEnvironmentDetails-Objekt werden die Informationen gespeichert, die zur Identifizierung der Lab-Umgebung in Build-, Bereitstellungs- und Testszenarien erforderlich sind. Sie können auf das LabEnvironmentDetails-Objekt, das vom Lab Management-Workflow-Assistenten erstellt wird, mit der EnvironmentDetails-Eigenschaft des LabWorkflowParameters Argument-Arguments zugreifen.

Eigenschaften

ProjectName	Eine String, die den Namen des Teamprojekts angibt
LabEnvironmentName	Eine String, die den Namen der Lab-Umgebung angibt
NewLabEnvironmentName	Eine String, die den Namen der zu erstellenden Lab-Umgebung angibt.
HostGroupName	Eine String, die den Namen der Hostgruppe angibt, in der die Umgebung bereitgestellt wird.
LabLibraryShareName	Eine String, die den Namen der Bibliotheksfreigabe angibt, die die gespeicherte Vorlage der Lab-Umgebung enthält.
RevertToSnapshot	Ein Boolean, der angibt, ob für die Umgebung ein Rollback in eine Momentaufnahme ausgeführt werden soll.
SnapshotName	Eine String, die den Namen der Umgebungsmomentaufnahme angibt, in die das Rollback ausgeführt werden soll.
TfsUrl	Eine String, die die URL des Team Foundation Server-Computers angibt.
LabEnvironmentUri	Ein Uri, mit dem der URI der ausgewählten Umgebung angegeben wird.
Disposition	Ein LabEnvironmentDisposition-Enumerationswert, der den Status der Umgebung angibt. Folgende Werte sind möglich: Unbekannt – Der Status der Umgebung ist nicht bekannt. Aktiv – Die Umgebung wird auf einem Host bereitgestellt und kann gestartet und ausgeführt werden. Gespeichert – Die Umgebung wird in einer Bibliotheksfreigabe gespeichert und kann erst nach der Bereitstellung verwendet werden.

Zurück nach oben

RunTestDetails

Mit einem RunTestDetails-Objekt werden die Details der Testparameter gespeichert, die erforderlich sind, um den automatisierten Testlauf im Build-, Bereitstellungs- und Testworkflow zu erstellen. Sie können auf das RunTestDetails-Objekt, das vom Lab Management-Assistenten erstellt wird, mit der TestParameters-Eigenschaft des LabWorkflowParameters Argument Arguments zugreifen.

Eigenschaften

TfsUrl	Eine String, die die URL des Team Foundation Server-Computers angibt.
Projektname	Eine String, die den Namen des Teamprojekts angibt.
TestConfigurationId	Eine Int32, die die ID der Testkonfiguration für den Testlauf angibt.
TestPlanId	Eine Int32, die die ID des Testplans angibt
TestSuiteIdList	Ein Systems.Collections.Generic.List<int>-Objekt, das die numerischen IDs der auszuführenden Testsammlungen beinhaltet
TestSettingsId	Eine Int32, die die ID der Testeinstellungen für den Testlauf angibt.
RunTest	Ein Boolean, der angibt, ob der Test ausgeführt werden soll.

Zurück nach oben

ScriptDetails

Beinhaltet detaillierte Informationen zu Bereitstellungsskripts. Ein ScriptDetails-Objekt ist erforderlich, wenn Sie dem Workflow-Designer eine RunDeploymentScript-Aktivität hinzufügen. InitializeAgentSpecAndEnvironmentVariables gibt ein ScriptDetails-Objekt zurück.

Eigenschaften

LabSystemName	Eine String, die den Namen der Lab-Umgebung angibt.
AgentSpec	Ein AgentReservationSpec-Objekt, das Tags beinhaltet, die einem Build-Agent im Lab-System zugeordnet sind.
FileName	Eine String, die den Namen der Bereitstellungsskriptdatei angibt.
Argumente	Eine String, die die Argumente angibt, die an das Bereitstellungsskript übergeben werden sollen.
WorkingDirectory	Eine String, die das Arbeitsverzeichnis für das Bereitstellungsskript auf dem Lab-System angibt.
EnvironmentVariables	Ein System.Collection.Generic.IDictionary<String,String>-Objekt, das die Name/Wert-Paare der Umgebungsvariablen beinhaltet.

Zurück nach oben

TestRunStatistics

Speichert Details eines Testlaufs. Ein TestRunStatistics-Objekt wird von der ExecuteRemoteTestRun-Aktivität zurückgegeben.

Eigenschaften

TotalTests	Ein Int32, das die Gesamtzahl der Tests im Testlauf angibt.
PassedTests	Ein Int32, das die Gesamtzahl der erfolgreichen Tests im Testlauf angibt.
FailedTests	Eine Int32, die die Gesamtzahl der fehlgeschlagenen Tests im Testlauf angibt.
InconclusiveTests	Eine Int32, die die Anzahl der Tests angibt, die im Testlauf nicht eindeutig sind.
PendingTests	Eine Int32, die die Anzahl der Tests angibt, die im Testlauf noch nicht ausgeführt wurden.
AbortedTests	Eine Int32, die die Anzahl der Tests angibt, die im Testlauf abgebrochen wurden.
InProgressTests	Eine Int32, die die Anzahl der Tests angibt, die im Testlauf derzeit ausgeführt werden.
TestRunStatus	Ein TestRunState-Enumerationswert, der den Status des Testlaufs angibt.
TestRunId	Eine Int32, die den Bezeichner des Testlaufs angibt.

Zurück nach oben

LabEnvironmentInUseMarker

Speichert Details des Markers "In Gebrauch" einer Umgebung. Mit der GetLabEnvironmentInUseMarker-Aktivität kann ein LabEnvironmentInUseMarker-Objekt zurückgegeben werden.

Eigenschaften

Benutzer	Eine String, die den Benutzer angibt, der die Umgebung markiert hat.
Timestamp	Ein DateTime-Objekt, das die Uhrzeit angibt, zu der der Benutzer die Umgebung markiert hat.
Kommentar	Eine String, die von dem Benutzer angegeben wird, der die Umgebung markiert hat.

Zurück nach oben

LabEnvironmentState

Eine Enumeration, die den aktuellen Zustand der Umgebung angibt. Der Zustand einer Lab-Umgebung wird hauptsächlich vom jeweiligen Zustand der darin enthaltenen virtuellen Computer bestimmt. Wenn sich alle virtuellen Computer in einem konsistenten und stabilen Zustand befinden, lautet der LabEnvironmentState-Wert entsprechend. Andernfalls ist der Wert Gemischt oder Fehlgeschlagen. Wenn ein Vorgang in der Umgebung läuft, befindet sich die Lab-Umgebung in einem Übergangszustand, der den laufenden Vorgang angibt.

LabEnvironmentState verfügt über folgende Werte:

Unbekannt

Erstellen

CreateFailed

CreateCancelling

Aktualisieren

Gespeichert

Starting

Running

Pausing

Paused

Stopping

Beendet

CreatingSnapshot

DeletingSnapshot

RestoringSnapshot

Löschen

DeleteFailed

Deleted

Gemischt

Fehler

UnderMigration

Siehe auch

Weitere Ressourcen

LabDefaultTemplate Workflow

Änderungsprotokoll

Datum	Versionsgeschichte	Grund
August 2010	Abschnitt "Objekte und Argumente" wurde hinzugefügt.	Informationsergänzung.