Releaseverwaltungstools zum Bereitstellen einer App

Artikel
12/17/2014

Jede Versionsaktion wird von einem Releaseverwaltungstool bereitgestellt. Beispielsweise wird mit dem Tool "Befehlszeilenausführung" eine bestimmte ausführbare Datei für eine Aktion ausgeführt. Wenn Sie eine Aufgabe ausführen müssen, die nicht von den verfügbaren Tools unterstützt wird, können Sie ein eigenes benutzerdefiniertes Tool erstellen und dieses einer benutzerdefinierten Versionsaktion hinzufügen. Tools können auch verwendet werden, um eine Komponente Ihrer App bereitzustellen.

Im Folgenden finden Sie eine Liste der Tools und ihrer Parameter, die mit Release Management bereitgestellt werden:

Deployment Agent-Datenbank – Ausführbares Skript

Dieses Tool führt eine SQL-Abfrage in einer bestimmten Datenbank aus. Es basiert auf der ausführbaren Standarddatei "sqlcmd", die mit SQL Server bereitgestellt wird. Weitere Informationen über diese ausführbare Datei finden Sie in der Dokumentation zu "sqlcmd". Die Konfigurationsvariablen für dieses Tool lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-S	ServerName	Ja	Der Servername der SQL-Datenbank.
-i	ScriptName	Ja	Der Name des auszuführenden Skripts.
-b	Nicht zutreffend	Nein	Dieser Parameter ist ein Switch. Ist er vorhanden, wird der Batch bei einem Fehler abgebrochen.

Deployment Agent für Reporting Services

Dieses Tool stellt Berichte der Reporting Services und verwandte Objekte bereit. Es basiert auf einer benutzerdefinierten ausführbaren Datei der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-s	serverUrl	Ja	Die vollständige URL des Reporting Services-Servers.
-l	itemLocation	Ja, bei mehreren Elementen	Der Speicherort der Elemente. Wenn angegeben, muss der Ordner angegeben werden (-f).
-f	folder	Ja, bei mehreren Elementen	Der Ordner der Elemente. Wenn angegeben, muss der Speicherort des Elements angegeben werden (-l).
-t		Ja	Der Elementtyp, der verarbeitet werden soll. Folgende Werte sind zulässig: Bericht Bild
-sp		Nein	Eine Liste von Suchmustern, die zum Filtern der Elemente verwendet werden. Die Suchmuster müssen durch ein Komma oder ein Semikolon voneinander getrennt angegeben werden (z. B. .bmp;.jpg). Wird nichts angegeben, lautet das Suchmuster je nach ausgewähltem Elementtyp (-t) wie folgt: Report: .rdl Picture: .bmp,.gif,.jpg,.jpeg,.png
-i		Ja, bei einzelnen Elementen	Elementdatei. Wenn angegeben, muss der Name des Elements angegeben werden (-n). Dieser Parameter wird verwendet, wenn ein einzelnes Element bereitgestellt werden muss. Ist das der Fall, dürfen die Parameter für den Speicherort (-l) und den Ordner (-f) des Elements nicht vorhanden sein.
-n		Ja, bei einzelnen Elementen	Elementname. Wenn angegeben, muss der Name des Elements angegeben werden (-i). Dieser Parameter wird verwendet, wenn ein einzelnes Element bereitgestellt werden muss. Ist das der Fall, dürfen die Parameter für den Speicherort (-l) und den Ordner (-f) des Elements nicht vorhanden sein.
-log		Nein	Im physischen Verzeichnis wird eine Protokolldatei mit dem angegebenen Namen generiert.
-o	Nicht zutreffend	Nein	Dieser Parameter ist ein Switch. Wenn er vorhanden ist, wird das Ziel überschrieben, sofern es bereits vorhanden ist.
-ds ds1,...,dsN			Die durch Kommas getrennten vollqualifizierten Namen aller dem Element zugeordneten Datenquellen. Bei diesen Werten muss die Groß-/Kleinschreibung beachtet werden. Diese Option gilt nur für Berichte. Die Datenquelle kann das Format "[Name:] Verweis" haben. "Name" ist der Name der Datenquelle, die in dem Bericht angegeben ist, in dem die Verweise ersetzt werden sollen. "Verweis" ist der vollqualifizierte Verweis auf die Datenquelle auf dem Zielserver, die für den Bericht verwendet wird.

Deployment Agent für MSI

Mit diesem Tool wird eine MSI-Datei bereitgestellt. Es deinstalliert die vorherige Installation des Produkts, bevor es die neue installiert. Es basiert auf einem benutzerdefinierten ausführbaren PowerShell-Skript der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-command	Nicht zutreffend	Ja	Fester Wert ./msiexec.ps1.
-MsiFileName	Installer	Ja	Der vollständige Pfad (falls erforderlich) und Name der zu installierenden MSI-Datei.
-MsiCustomArgs	MsiCustomArgs	Nein	Die benutzerdefinierten Argumente, die zur Installation der MSI-Datei verwendet werden sollen. Diese Argumente werden direkt an die ausführbare msiexec-Datei übergeben. Wenn keine benutzerdefinierten Argumente erforderlich sind, muss der Parameter aus den Argumenten entfernt werden.
-PrevProductName		Nein	Dies ermöglicht die Angabe des Namens des vorherigen Produkts, das vor der Installation der MSI-Datei deinstalliert werden soll. Standardmäßig wird vom System der Produktname in der zu installierenden MSI-Datei verwendet.

Deployment Agent für XCopy

Dieses Tool kopiert einen Paketspeicherort an ein bestimmtes Ziel. Es basiert auf einem benutzerdefinierten ausführbaren Batch-Skript der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-source	Nicht zutreffend	Ja	Ein fester Wert, der angibt, dass alle Quellspeicherorte kopiert werden müssen.
-destination	Installation Path	Ja	Das Ziel des Kopiervorgangs.

Befehlszeilenausführung

Dieses Tool führt eine bestimmte ausführbare Datei aus. Es basiert auf einem benutzerdefinierten ausführbaren PowerShell-Skript der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-file	Nicht zutreffend	Ja	Fester Wert. / RunCommandLine.ps1.
-FilePath	FilePath	Ja	Der vollständige Pfad (falls erforderlich) und Dateiname der auszuführenden ausführbaren Datei.
-Arguments	Argumente	Nein	Die erforderlichen Argumente bei Ausführung der ausführbaren Datei.
-UserDomain	UserDomain	Nein	Die Domäne des Benutzers, die verwendet wird, wenn die ausführbare Datei unter einer bestimmten Identität ausgeführt werden muss. Wird dies nicht angegeben, wird der lokale Benutzer verwendet (. \localuser).
-UserName	UserName	Nein	Der Name des Benutzers, der verwendet wird, wenn die ausführbare Datei unter einer bestimmten Identität ausgeführt werden muss.
-UserPassword	UserPassword	Nein	Das Kennwort des Benutzers, das verwendet wird, wenn die ausführbare Datei unter einer bestimmten Identität ausgeführt werden muss.

Windows-Registrierungs-Manager

Mit diesem Tool können Registrierungsinformationen in Windows bearbeitet werden. Es basiert auf einem benutzerdefinierten ausführbaren PowerShell-Skript der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-command	Nicht zutreffend	Ja	Fester Wert ./ManageWindowsRegistry.ps1.
-Action	Aktion	Ja	Die auszuführende Aktion. Folgende Werte sind zulässig: CreateKey : Einen neuen Registrierungsschlüssel erstellen ModifyKey : Einen Registrierungsschlüssel oder dessen Daten ändern DeleteKey : Einen Registrierungsschlüssel mit all seinen Werten und Unterschlüsseln löschen. CreateValue : Einen neuen Registrierungswert unter einem Schlüssel erstellen ModifyValue : Einen Registrierungswert unter einem Schlüssel ändern DeleteValue : Einen Registrierungswert unter einem Schlüssel löschen
-OperatingSystemType		Nein	Gibt an, ob auf den Schlüssel/Wert in der 32-Bit- oder 64-Bit-Registrierung zugegriffen wird. Wird dies nicht angegeben, ist der Standardwert 32-Bit.
-RegistryKey	RegistryKey	Ja	Der Pfad und der Name des Registrierungsschlüssels (z. B. HKLM\Software\MyKey).
-RegistryValue		Nein*	Der Registrierungswert, auf den Änderungen angewendet werden (z. B. MyValue). Dies ist bei "CreateValue", "ModifyValue" und "DeleteValue" erforderlich.
-ValueType		Nein	Der Typ des betroffenen Werts. Folgende Werte werden akzeptiert: REG_SZ: Zeichenfolge (Standardwert, wenn nicht angegeben). REG_QWORD_LITTLE_ENDIAN : A 64-Bit-Zahl in Little-Endian-Format REG_QWORD : A 64-Bit-Zahl REG_NONE: Kein Wert REG_MULTI_SZ: Multi-Linienzeichenfolge (getrennt durch \0) REG_LINK : Symbolischer Link REG_EXPAND_SZ: Zeichenfolge mit nicht erweiterten Verweisen auf Umgebungsvariablen REG_DWORD_BIG_ENDIAN : A 32-Bit-Zahl im Big-Endian-Format REG_DWORD_LITTLE_ENDIAN : A 32-Bit-Zahl im Little-Endian-Format REG_DWORD : A 32-Bit-Zahl REG_BINARY : Binärdaten jeder Art
-RegistryData		Nein	Die Daten, die entweder auf den Wert (bei Verwendung von CreateValue oder ModifyValue) oder auf den Standardwert des Schlüssels (bei Verwendung von CreateKey oder ModifyKey) angewendet werden.
-RegistryKeyDestination		Nein*	Der Name des Registrierungsschlüssels, der verwendet wird, wenn die Aktion "ModifyKey" zum Umbenennen eines Registrierungsschlüssels verwendet wird. Beispiel: RegistryKey = HKLM\Software\MyKey RegistryKeyDestination = HKLM\Software\MyModifiedKey (für "ModifyKey" erforderlich).

Gemeinsame Windows-E/A

Dieses Tool führt allgemeine E/A-Aufgaben unter Windows aus. Es basiert auf einem benutzerdefinierten ausführbaren PowerShell-Skript der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-command	Nicht zutreffend	Ja	Fester Wert ./ManageWindowsIO.ps1
-Action	Aktion	Ja	Geben Sie die auszuführende Aktion an: Erstellen: Erstellen eines neuen Ordners Löschen: Löschen von Dateien oder Ordnern Umbenennen: Umbenennen einer Datei oder eines Ordners Verschieben: Verschieben einer Datei oder eines Ordners Attrib : Ändern der Attribute (einschließlich Besitz) von Dateien oder Ordnern
-FileFolderName	FileFolderName	Ja	Pfad und Name der Datei oder des Ordners
-DestinationName		Nein*	Der Zielname (für die Umbenennungsaktion) oder der Ordnerpfad und -name (für die Verschiebungsaktion). Erforderlich für Umbenennungs- und Verschiebungsaktionen.
-ReadOnly		Nein	Zulassen, dass der Benutzer das Attribut "Schreibgeschützt" der Dateien oder des Ordners festlegt oder zurücksetzt. + : Legt das Flag fest - : Setzt das Flag zurück Jeder andere Wert: Das Flag bleibt unverändert.
-Archive		Nein	Zulassen, dass der Benutzer das Attribut "Archive" der Dateien oder des Ordners festlegt oder zurücksetzt. + : Legt das Flag fest - : Setzt das Flag zurück Jeder andere Wert: Das Flag bleibt unverändert.
-System		Nein	Zulassen, dass der Benutzer das Attribut "System" der Dateien oder des Ordners festlegt oder zurücksetzt. + : Legt das Flag fest - : Setzt das Flag zurück Jeder andere Wert: Das Flag bleibt unverändert.
-Hidden		Nein	Zulassen, dass der Benutzer das Attribut "Ausgeblendet" der Dateien oder des Ordners festlegt oder zurücksetzt. + : Legt das Flag fest - : Setzt das Flag zurück Jeder andere Wert: Das Flag bleibt unverändert.
-OwnerDomain		Nein	Stellt die Domäne des neuen Besitzers der Datei oder des Ordners dar.
-OwnerName		Nein	Stellt den Namen des neuen Besitzers der Datei oder des Ordners dar.

Windows-Dienst-Manager

Mit diesem Tool werden Windows-Dienste verwaltet. Es basiert auf einem benutzerdefinierten ausführbaren PowerShell-Skript der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-command	Nicht zutreffend	Ja	Fester Wert ./ManageWindowsServices.ps1.
-Action	Aktion	Ja	Geben Sie die auszuführende Aktion an: Create : Erstellen eines neuen Diensts Config : Konfigurieren eines vorhandenen Diensts Delete : Löschen eines vorhandenen Diensts Start : Starten eines Diensts Stop : Beenden eines Diensts Restart: Beenden und Starten eines Diensts
-ServiceName	ServiceName	Ja	Name des Diensts.
-ServerName		Nein	Der Name des Servers, auf dem die Aktion ausgeführt wird. Wenn dieser nicht angegeben wird, wird der aktuelle Server verwendet.
-BinPath		Nein*	Der Binärpfad und der Name des Diensts. Ist für die Aktion "Create" erforderlich, für die Aktion "Config" optional und wird von allen anderen ignoriert.
-DisplayName		Nein	Der Anzeigename, der für den Dienst verwendet wird. Er ist für die Aktionen "Create" und "Config" optional und wird von allen anderen ignoriert.
-Description		Nein	Die Beschreibung für den Dienst. Er ist für die Aktionen "Create" und "Config" optional und wird von allen anderen ignoriert.
-UserName		Nein	Der Benutzername, der für die Anmeldeinformationen zum Starten des Diensts verwendet wird (muss in folgender Form vorliegen: DOMAIN\USER). Wenn er bereitgestellt wird, muss der Parameter "–Passwort" ebenfalls bereitgestellt werden. Wird er nicht bereitgestellt, wird standardmäßig das Konto "LocalSystem" verwendet. Er ist für die Aktionen "Create" und "Config" optional und wird von allen anderen ignoriert. Um die Anmeldeinformationen auf "LocalSystem" zurückzusetzen, geben Sie "LocalSystem" als Benutzer und zwei Anführungszeichen ("") als Kennwort ein.
-Password		Nein	Das Kennwort des zum Starten des Diensts angegebenen Benutzernamens. Er ist für die Aktionen "Create" und "Config" optional und wird von allen anderen ignoriert.
-StartMode		Nein	Startmodus des Diensts. Standardmäßig wird der Dienst mit der Option "Automatisch" erstellt. Dabei stehen folgende Möglichkeiten zur Verfügung: Manual : Dienst wird nur manuell gestartet Automatic : Dienst wird beim nächsten Neustart des Computers automatisch gestartet. Disabled : Dienst ist deaktiviert Er ist für die Aktionen "Create" und "Config" optional und wird von allen anderen ignoriert.

Deployment Agent für DACPAC-Datenbank

Mit diesem Tool wird ein DACPAC-Paket bereitgestellt. Es basiert auf einem Hilfsprogramm der SQL Server-Befehlszeile. Für diese ausführbare Datei sind viele mögliche Parameter verfügbar. Im Folgenden werden jedoch nur die für dieses Tool verwendeten Parameter aufgeführt. Weitere Informationen finden Sie unter SqlPackage.exe. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
/Action:		Ja	Fester Wert: Publish – Gibt an, dass das Paket veröffentlicht wird.
/SourceFile:	FileName	Ja	Der vollständige Pfad (falls erforderlich) und Dateiname von DACPAC.
/TargetServerName:	ServerName	Ja	Der Name der SQL Server-Instanz, auf der das Paket veröffentlicht werden soll.
/TargetDatabaseName:	DatabaseName	Ja	Der Name der SQL Server-Datenbank, in der das Paket veröffentlicht werden soll.

Deployment Agent für IIS

Mit diesem Tool werden IIS-Objekte und -Einstellungen bearbeitet. Es basiert auf einer benutzerdefinierten ausführbaren Datei der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools variieren je nach der Art der auszuführenden Aktion.

Für Anwendungspoolaktionen gelten Folgende:

Parameter	Erforderlich	Beschreibung
-Action	Ja	Geben Sie die auszuführende Aktion an: CreateApplicationPool ConfigureApplicationPool DropApplicationPool StartApplicationPool StopApplicationPool RecycleApplicationPool
-ap	Ja	Name des Anwendungspools.
-apAllow32Bit	Nein	Das Flag, mit dem angegeben wird, ob der Anwendungspool 32-Bit-Anwendungen zulassen muss. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Folgende Werte sind zulässig: 1 oder True: 32-Bit-Anwendungen sind zulässig. 0 oder False: 32-Bit-Anwendungen sind nicht zulässig.
-apIdentUserDomain	Nein	Die Domäne des Benutzers, der als Identität des Anwendungspools auftritt. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Ist dies nicht definiert, aber "IdentityUserName" ist definiert, wird der Benutzer als lokaler Benutzer betrachtet (. \localuser).
-apIdentUserName	Nein	Der Benutzername, der als Identität des Anwendungspools verwendet wird. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Ist dies nicht definiert, werden "IdentityUserDomain" und "IdentityUserPassword" ignoriert, und der Standardwert von IIS wird verwendet (ApplicationPoolIdentity).
-apIdentUserPassword	Nein	Das Kennwort des Benutzers, der als Identität des Anwendungspools verwendet wird. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig.
-apNetVers	Nein	Die .NET Framework-Version, die für den Anwendungspool verwendet wird. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Die folgenden Werte sind zulässig: v1.0, v1.1, v2.0, v4.0
-apPipelineMode	Nein	Der verwaltete Pipelinemodus, der im Anwendungspool verwendet wird. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Folgende Werte sind zulässig: Classic Integrated
-apProcessIdleTimeout	Nein	Die Zeit in Minuten, die sich ein Prozess im Anwendungspool im Leerlauf befinden kann. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig.
-apRecycleKbMemory	Nein	Die maximale Menge Arbeitsspeicher (in KB), die verwendet wird, bevor der Anwendungspool wiederverwendet wird. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig.
-apRecycleMinutes	Nein	Eine feste Zeitspanne in Minuten, nach der der Anwendungspool wieder verwendet wird. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig.
- apRecycleSpecificTime	Nein	Ein fester Zeitpunkt, an dem der Anwendungspool wieder angewendet wird. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Das erforderliche Format lautet: HH:MM (z. B. 23:58 oder 01:23).
-apStartMode	Nein	Der Startmodus, der für den Anwendungspool verwendet wird. Dieser Parameter ist nur für IIS 8.0 und 8.5 zulässig. Folgende Werte sind zulässig: OnDemand AlwaysRunning
-AutoStart	Nein	Das Flag, das angibt, ob der Anwendungspool automatisch gestartet werden muss. Dieser Parameter ist nur für IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Folgende Werte sind zulässig: 1 oder True: Der Anwendungspool wird beim Start von Windows automatisch gestartet. 0 oder False: Der Anwendungspool wird beim Start von Windows nicht automatisch gestartet.
-log	Nein

Für Websiteaktionen gelten Folgende:

Parameter	Erforderlich	Beschreibung
-Action	Ja	Geben Sie die auszuführende Aktion an: CreateWebSite ConfigureWebSite DropWebSite StartWebSite StopWebSite RestartWebSite
-sn	Ja	Websitename
-port	Nein*	Die Portnummer der Website. Ist für die Aktion zum Erstellen erforderlich und beim Konfigurieren optional.
-pd	Nein*	Der vollständige Pfad zum Speicherort, an dem die Anwendung veröffentlicht wurde. Ist für die Aktion zum Erstellen erforderlich und beim Konfigurieren optional. Hinweis Stellen Sie sicher, dass kein nachgestellter Schrägstrich im Pfad vorhanden ist.
-ap	Nein	Der Name des Anwendungspools. Wird er bei der Erstellung des Anwendungspools nicht angegeben, wird der Standardanwendungspool verwendet. Ist für die Aktionen "Erstellen" und "Konfigurieren" optional.
-EnablePreload	Nein	Ist in IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Flag, das angibt, ob die Website vorab geladen werden muss. Ist für die Aktionen "Erstellen" und "Konfigurieren" optional. Zulässige Werte sind: 1 oder True: "Vorab laden" ist aktiviert 0 oder False: "Vorab laden" ist deaktiviert
-AutoStart	Nein	Ist in IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Flag, das angibt, ob die Website automatisch gestartet werden muss. Ist für die Aktionen "Erstellen" und "Konfigurieren" optional. Zulässige Werte sind: 1 oder Wahr: Automatisch starten 0 oder Falsch: Nicht automatisch starten
-log	Nein	Im physischen Verzeichnis wird eine Protokolldatei mit dem angegebenen Namen generiert.

Für Webanwendungsaktionen gelten Folgende:

Parameter	Erforderlich	Beschreibung
-Action	Ja	Geben Sie die auszuführende Aktion an: CreateWebApplication ConfigureWebApplication DropWebApplication
-ws	Ja	Der Name der zu erstellenden Anwendung.
-pd	Nein*	Der vollständige Pfad zum Speicherort, an dem die Anwendung veröffentlicht wurde. Ist für die Aktion zum Erstellen erforderlich und beim Konfigurieren optional.
-sn	Nein	Websitename. Sofern nicht anders angegeben, wird vom System bei der Erstellung der neuen Anwendung die Standardwebsite verwendet. Ist für die Aktionen "Erstellen" und "Konfigurieren" optional.
-ap	Nein	Der Name des Anwendungspools. Wird er bei der Erstellung des Anwendungspools nicht angegeben, wird der Standardanwendungspool verwendet. Ist für die Aktionen "Erstellen" und "Konfigurieren" optional.
-EnablePreload	Nein	Ist in IIS 7.0, 7.5, 8.0 und 8.5 zulässig. Flag, das angibt, ob die Website vorab geladen werden muss. Ist für die Aktionen "Erstellen" und "Konfigurieren" optional. Zulässige Werte sind: 1 oder True: "Vorab laden" ist aktiviert 0 oder False: "Vorab laden" ist deaktiviert
-log	Nein	Im physischen Verzeichnis wird eine Protokolldatei mit diesem Namen generiert.

Für Aktionen beim virtuellen Verzeichnis gelten Folgende:

Parameter	Erforderlich	Beschreibung
-Action	Ja	Geben Sie die auszuführende Aktion an: CreateVirtualDirectory ConfigureVirtualDirectory DropVirtualDirectory
-vd	Ja	Der Name des virtuellen Verzeichnisses.
-pd	Nein*	Der vollständige Pfad des virtuellen Verzeichnisses. Ist für die Aktion zum Erstellen erforderlich und beim Konfigurieren optional.
-sn	Nein	Websitename. Sofern nicht anders angegeben, wird vom System bei der Erstellung der neuen Anwendung die Standardwebsite verwendet. Ist für die Aktionen "Erstellen" und "Konfigurieren" optional.
-ws	Nein	Der Name der Webanwendung. Sofern nicht anders angegeben, wird vom System bei der Erstellung des neuen virtuellen Verzeichnisses die Stammwebanwendung verwendet. Ist für die Aktionen "Erstellen" und "Konfigurieren" optional.
-log	Nein	Im physischen Verzeichnis wird eine Protokolldatei mit diesem Namen generiert.

Microsoft Azure VM Manager

Mit diesem Tool wird ein virtueller Computer (VM) in Microsoft Azure verwaltet. Es basiert auf einem benutzerdefinierten ausführbaren PowerShell-Skript der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-command	Nicht zutreffend	Ja	Fester Wert ./ControlAzureVM.ps1.
-Command		Ja	Geben Sie die auszuführende Aktion an: Start: Starten der VM Stop: Beenden der VM
-ServiceName	ServiceName	Ja	Das ist der Name des Microsoft Azure-Diensts, in dem die VM vorhanden ist.
-Name	Name	Ja	Das ist der Name der Microsoft Azure-VM.

XBAP-Bereitsteller

Mit diesem Tool wird eine XBAP-Anwendung bereitgestellt. Es basiert auf einer benutzerdefinierten ausführbaren Datei der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-pn	ProjectName	Ja	Der Name des bereitzustellenden XBAP-Projekts.
-d	Installation Path	Ja	Der Installationspfad für die XBAP-Anwendung.
-ml		Nein	Der vollständige Pfad zur ausführbaren Datei des Mage-Hilfsprogramms. Wird nichts anderes angegeben, wird vom Tool der als Ressource im Tool angegebene Pfad verwendet.
-pl		Nein	Der vollständige Pfad zum Speicherort des bereitzustellenden XBAP-Projekts. Wird nichts anderes angegeben, wird vom Tool der Speicherort verwendet, an dem das Paket ausgeführt wird.
-url		Nein	Sofern angegeben, wird die URL der Datei "Setup.exe" durch die angegebene URL ersetzt.
-cf		Nein	Sofern angegeben, wird dies bei Aktualisierung des Manifests als Anmeldename verwendet.
-pwd		Nein	Sofern angegeben, wird dies bei Aktualisierung des Manifests als Anmeldekennwort verwendet.
-log		Nein	Im physischen Verzeichnis wird eine Protokolldatei mit diesem Namen generiert.

Microsoft Test Manager (MTM)-Befehlszeilenprogramm

Dieses Tool ermöglicht die Erstellung und den Start automatischer Test, die auf MTM (Microsoft Test Manager) ausgeführt werden. Es basiert auf einem benutzerdefinierten ausführbaren PowerShell-Skript der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-command	Nicht zutreffend	Ja	Fester Wert ./TcmExec.ps1.
-Title	TestRunTitle	Ja	Der Name, der bei Erstellung des Testlaufs verwendet wird.
-PlanId	PlanId	Ja	Der Bezeichner des Testplans, unter dem der Test ausgeführt werden muss ("Eindeutige ID" wie im Test Manager definiert).
-SuiteId	SuiteId	Ja	Der Bezeichner der Auflistung, die Sie ausführen möchten ("Eindeutige ID" wie im Test Manager definiert).
-ConfigId	ConfigId	Ja	Der Bezeichner der Testkonfiguration, unter der der Test ausgeführt werden muss (Eindeutige ID wie im Test Manager definiert).
-Collection	TFSCollection	Ja	Die Auflistungs-URL von Team Foundation Server, für die die automatisierten Tests ausgeführt werden.
-TeamProject	TeamProject	Ja	Der Name des Teamprojekts, in dem die automatisierten Tests konfiguriert wurden.
-TestEnvironment	TestEnvironment	Ja	Die Testumgebung, in der die Tests ausgeführt werden sollen (die Testumgebung ist einem entsprechenden Test Controller zugeordnet).
-BuildDirectory	BuildDirectory	Nein*	Der Speicherort der automatisierten Tests. In MTM 2010 ist dieser Parameter erforderlich. In MTM 2012, 2013 wird dieser Parameter noch unterstützt, doch sollten Benutzer vorzugsweise die Parameter BuildDefinition und BuildNumber verwenden.
-BuildDefinition		Nein*	Ermöglicht die Angabe der Builddefinition, in der die automatisierten Tests enthalten sind. Dieser Parameter kann nur mit MTM 2012 verwendet werden. Wenn er definiert wurde, muss der BuildNumber-Parameter ebenfalls angegeben werden. Wird er nicht angegeben, wirkt sich der Testlauf nicht auf das Feld "Build" aus, das unter den Details eines Testlaufs angezeigt wird.
-BuildNumber		Nein*	Ermöglicht die Angabe der Buildnummer, in deren Ablagespeicherort die automatisierten Tests enthalten sind. Dieser Parameter kann nur mit MTM 2012 verwendet werden. Wenn er definiert wurde, muss der BuildDefinition-Parameter ebenfalls angegeben werden. Wird er nicht angegeben, wirkt sich der Testlauf nicht auf das Feld "Build" aus, das unter den Details eines Testlaufs angezeigt wird.
-SettingsName		Nein	Ermöglicht die Angabe der für den Testlauf zu verwendenden Einstellungen. Wird dies nicht angegeben, werden die standardmäßigen Testeinstellungen verwendet.
-TestRunWaitDelay		Nein	Ermöglicht die Angabe der Verzögerung zwischen jedem Aufruf des Test Controllers in Sekunden. Das ist erforderlich, damit der Testlauf abgeschlossen werden kann, bevor die Testergebnisse verarbeitet werden. Wird dies nicht angegeben, werden standardmäßig 10 Sekunden festgelegt.
-InconclusiveFailsTests	Nicht zutreffend	Nein	Wenn dieses Flag festgelegt ist, wird die Bereitstellung bei Vorhandensein von nicht eindeutigen Tests einen Fehler verursachen. Standardmäßig wird bei einem nicht eindeutigen Test kein Fehler bei der Bereitstellung verursacht.
-RemoveIncludeParameter	Nicht zutreffend	Nein	Wenn dieser Flag festgelegt ist, wird der Parameter "/include" nicht an den Erstellungsbefehl des Tests angehängt. Das bedeutet, dass alle Tests, die über einen anderen Status als "Aktiv" verfügen, nicht im Testlauf eingeschlossen werden.

Wenn die automatisierten Tests im gleichen Buildprozess enthalten sind wie die Anwendung, die bereitgestellt wird, können die Metadaten als Variablenwert verwendet und automatisch zur Versionszeit ersetzt werden. Im Folgenden werden die aktuell verfügbaren Metadaten aufgelistet, die mit Konfigurationsvariablen verwendet werden können:

Variable	Variablenwert-Metadaten
BuildDirectory	$(PackageLocation)
BuildNumber	$(BuildNumber)
BuildDefinition	$(BuildDefinition)
TFSCollection	$(TFSUrlWithCollection)
TeamProject	$(TeamProject)

INI-Datei-Manager

Mit diesem Tool wird der Inhalt einer INI-Datei geändert und eine neue INI-Datei erstellt, sofern angegeben. Es basiert auf einer benutzerdefinierten ausführbaren Datei der Releaseverwaltung. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-Action		Ja	Geben Sie die auszuführende Aktion an: ModifySection RemoveSection CreateKeyValue ModifyKeyValue RemoveKeyValue
-INIFile	INIFileName	Ja	Name und Pfad der INI-Datei (falls erforderlich).
-SectionName	SectionName	Nein	Der zu übertragende Abschnittsname. Wird dies nicht angegeben, wird der Stammabschnitt verwendet (alle Schlüssel, die sich am Anfang der Datei vor dem ersten Abschnitt befinden, werden als Stammabschnitt betrachtet).
-NewSectionName		Nein	Der neuen Abschnittsnamen. Wird dies nicht angegeben, wird der Stammabschnitt verwendet (alle Schlüssel, die sich am Anfang der Datei vor dem ersten Abschnitt befinden, werden als Stammabschnitt betrachtet). Er ist für die Aktion "ModifySection" erforderlich.
-KeyName		Nein	Der zu übertragende Schlüsselname. Dies ist bei "CreateKeyValue", "ModifyKeyValue" und "RemoveKeyValue" erforderlich.
-KeyValue		Nein	Der für den Schlüssel zu verwendende Wert. Wenn die Aktion "ModifyKeyValue" verwendet wird, und dieser Parameters ist nicht angegeben, aber der Parameter "NewKeyName" ist angegeben, wird vom System der tatsächliche Wert verwendet. Wenn weder dies noch "NewKeyName" angegeben ist, wird der Wert geleert.
-NewKeyName		Nein	Der neue Name, der dem Schlüssel gegeben wird. Er wird nur in der Aktion "ModifyKeyValue" verwendet.
-CreateFileIfNotExists		Nein	Dies gibt dem Tool an, dass eine Datei erstellt werden muss, wenn sie nicht vorhanden ist.

Windows-Prozess

Mit diesem Tool kann ein Windows-Prozess abgebrochen werden. Die Konfigurationsvariablen dieses Tools lauten wie folgt:

Parameter	Variable	Erforderlich	Beschreibung
-command	Nicht zutreffend	Ja	Fester Wert ./WindowsProcess.ps1.
-ProcessName		Ja	Der Name des aufzuhebenden Windows-Prozesses.
-UserName		Nein	Das den Prozess ausführende Benutzerkonto. Sofern nicht angegeben, wird der Prozess für alle Benutzer aufgehoben.
-IsKillProcessTree		Nein	Das Flag, das angibt, ob die Prozessstruktur beendet werden muss. Folgende Werte sind zulässig: 1: Prozessstruktur beenden 0 oder leer: Prozessstruktur nicht beenden

Share via