Freigabeaktionen zum Bereitstellen einer App für die Releaseverwaltung
Sie können Versionsaktionen hinzufügen, um die Bereitstellungssequenz für jede Versionsstufe zu definieren. Jede Aktion verwendet ein bestimmtes Tool, um einen Befehl mit einem Satz von Argumenten auszuführen.
Wenn Sie nicht den Versionspfad noch erstellt haben, fahren Sie hier, das verwendet.
Ziehen Sie eine Versionsaktion aus dem Werkzeugkasten, um sie der Bereitstellungssequenz hinzuzufügen. Verwenden Sie eine der vordefinierten Versionsaktionen aus dem Werkzeugkasten, oder erstellen Sie Ihre eigenen benutzerdefinierten Versionsaktionen.
.png "Registerkarte \"Apps konfigurieren\", Registerkarte \"Versionsvorlagen\"")
Nachdem Sie der Sequenz eine Versionsaktion hinzugefügt haben, können Sie die Konfigurationsvariablen nach Bedarf bearbeiten. Weitere Informationen über vordefinierte Versionsaktionen und deren Konfigurationsvariablen finden Sie hier. Erhalten Sie Informationen über die Tools out, die von Versionsaktionen verwendet werden hier.
Hinzufügen einer benutzerdefinierten Versionsaktion
Fügen Sie eine neue Versionsaktion hinzu, und wählen Sie das Tool aus, das von dieser Aktion verwendet werden soll. Oder kopieren Sie eine bestehende Aktion, und verwenden Sie diese als Grundlage zur Erstellung einer benutzerdefinierten Versionsaktion. Bestehende Versionsaktionen können nicht bearbeitet werden.
Öffnen Sie in Release Management Client die Seite "Bestand". (Wenn die Seite nicht angezeigt wird, müssen Sie die Berechtigung Darf Bestand verwalten anfordern.)
Kopieren Sie die Aktion, die Sie bearbeiten möchten, oder fügen Sie eine neue Aktion hinzu.
.png "Freigabeaktion kopieren")
Wählen Sie das Tool aus, das von der Aktion verwendet werden soll. Wählen Neu, um ein eigenes benutzerdefiniertes Tool hinzuzufügen, wenn vordefinierte Tools nicht möglich ist, die Sie für diesen Schritt in der Bereitstellungssequenz benötigen.
Geben Sie im Abschnitt Ausführung alle erforderlichen Argumente mit ihren Token im erforderlichen Format ein. Folgendes Präfix und Suffix müssen Sie jedem Parameter hinzufügen:__. Wenn Sie Argumente mit ihren Token löschen oder hinzufügen, wird dies in der Liste Parameter widergespiegelt.
Beispiel: Sie fügen folgende Argumente mit Token hinzu: -servername __servername__ -switch __onoff__. "servername" und "onoff" werden jetzt in der Liste der Parameter angezeigt.
So deaktivieren Sie eine Versionsaktion
- Wenn es Aktionen gibt, die das Team nicht verwenden soll, deaktivieren Sie diese. Öffnen Sie die Aktion auf der Seite "Bestand", und wählen Sie die Schaltfläche Deaktivieren.
So aktivieren Sie eine Versionsaktion wieder
Öffnen Sie die Liste "Inaktiv", öffnen Sie die Aktion, und wählen Sie Aktivieren.
.png "Inaktive Liste auf Seite \"Bestand\"")
F & A
.gif "Ff425471.collapse_all(de-de,VS.120).gif")
F: Welche Berechtigungen benötige ich, um Versionsaktionen zu bearbeiten?
A: Um Versionsaktionen zu bearbeiten oder hinzuzufügen, müssen Benutzer über die Berechtigung Darf Bestand verwalten verfügen. Wenn die Berechtigung nicht aktiviert ist, wird die Seite "Bestand" nicht angezeigt.
Wenn die Option "Kein Tool" ausgewählt ist, sind die Felder Befehl und Argumente nur bearbeitbar, wenn Sie über die Berechtigung Darf benutzerdefiniertes Tool in Aktionen und Komponenten verwenden verfügen. Wenn der Benutzer nicht über die Berechtigung Darf benutzerdefiniertes Tool in Aktionen und Komponenten verwenden verfügt, können die Felder Befehl und Argumente unter Apps konfigurieren, Komponenten nicht bearbeitet werden, solange die Option "Kein Tool" ausgewählt ist.
Aktionen und Konfigurationsvariablen für Versionsaktionen
Verwalten von Anwendungspools und Websites
Erstellen oder Bearbeiten von INI-Dateien
SQL Server-Datenbanken verwalten
Einrichten der Server
Verwalten von Windows-Diensten
Verwalten von Anwendungspools und Websites
Diese Aktionen verwenden das vordefinierte IIS Deployer-Tool, um Anwendungspools, Websites, Webanwendungen und virtuelle Verzeichnisse zu verwalten. Diese Aktionen werden unter IIS 7.0, 7.5, 8.0 und 8.5 unterstützt. Weitere Informationen über dieses Tool, wechseln Sie hier.
Aktion |
Verwendung und mögliche Gründe für Bereitstellungsfehler |
|---|---|
.png "leerer Abstandshalter") |
Anwendungspool erstellen: Mit dieser Aktion wird ein neuer Anwendungspool unter IIS erstellt. Gilt für IIS 7.0, 7.5, 8.0 und 8.5. Wenn der Anwendungspool bereits vorhanden ist, wird er neu konfiguriert, damit er den Werten der definierten Konfigurationsvariablen entspricht (nicht definierte Konfigurationsvariablen wirken sich nicht auf die tatsächliche Konfiguration des Anwendungspools aus). Unter IIS-Versionen vor 7.0 wird die Bereitstellung bei vorhandenem Anwendungspool einen Fehler verursachen. Anwendungspool konfigurieren, Anwendungspool wiederverwenden, Anwendungspool starten oder Anwendungspool beenden: Mit diesen Aktionen wird ein Anwendungspool konfiguriert, wiederverwendet, gestartet oder beendet. Die Bereitstellung schlägt fehl, wenn der Anwendungspool nicht vorhanden ist. |
|
Website erstellen: Erstellt eine neue Website unter IIS. Gilt für IIS 7.0, 7.5, 8.0 und 8.5. Ist die Website bereits vorhanden, wird der Anwendungspool neu konfiguriert, damit er den Werten der definierten Konfigurationsvariablen entspricht (nicht definierte Konfigurationsvariablen wirken sich nicht auf die tatsächliche Konfiguration der Website aus). Unter IIS-Versionen vor 7.0 wird die Bereitstellung bei vorhandenem Anwendungspool einen Fehler verursachen. Website konfigurieren, Website neu starten, Website starten, Website anhalten: Mit diesen Aktionen wird eine Webseite neu konfiguriert, neu gestartet, gestartet oder beendet. Die Bereitstellung schlägt fehl, wenn die Website nicht vorhanden ist. |
|
Webanwendung erstellen: Erstellt eine neue Webanwendung unter IIS. Gilt für IIS 7.0, 7.5, 8.0 und 8.5. Ist die Webanwendung bereits vorhanden, wird der Anwendungspool neu konfiguriert, damit er den Werten der definierten Konfigurationsvariablen entspricht (nicht definierte Konfigurationsvariablen wirken sich nicht auf die tatsächliche Konfiguration der Webanwendung aus). Unter IIS-Versionen vor 7.0 wird die Bereitstellung bei vorhandenem Anwendungspool einen Fehler verursachen. Mit Webanwendung konfigurieren wird eine Webanwendung neu konfiguriert. Die Bereitstellung schlägt fehl, wenn die Webanwendung nicht vorhanden ist. |
|
Virtuelles Verzeichnis erstellen: Erstellt ein virtuelles Verzeichnis unter IIS. Gilt für IIS 7.0, 7.5, 8.0 und 8.5. Sofern das virtuelle Verzeichnis bereits vorhanden ist, wird der Anwendungspool neu konfiguriert, damit er der den Werten der definierten Konfigurationsvariable entspricht (nicht definierte Konfigurationsvariablen wirken sich auf die tatsächliche Konfiguration des virtuellen Verzeichnisses nicht aus). Mit Virtuelles Verzeichnis konfigurieren wird ein virtuelles Verzeichnis neu konfiguriert. Die Bereitstellung schlägt fehl, wenn das virtuelle Verzeichnis nicht vorhanden ist. |
Konfigurationsvariablen
Parameter |
Erforderlich |
Beschreibung |
|---|---|---|
AppPoolName |
Ja [Aktionen für Anwendungspools] Nein [Websiteaktionen] |
Der Name des Anwendungspools, der konfiguriert, erstellt, wieder verwendet, entfernt, gestartet oder beendet werden soll. [Aktion für Anwendungspool] Der Name des Anwendungspools, der für eine neue oder geänderte Webseite verwendet werden soll. [Websiteaktion] |
DotNetVersion |
nein |
Die .NET Framework-Version, die für den Anwendungspool verwendet wird. Dieser Parameter ist nur für IIS 7.5, 8.0 und 8.5 zulässig. Die folgenden Werte sind zulässig: v1.0, v1.1, v2.0 oder v4.0. |
IdentityUserDomain |
nein |
Die Domäne des Benutzers, der als Identität des Anwendungspools auftritt. Ist er nicht definiert, und "IdentityUserName" ist definiert, wird der Benutzer als lokaler Benutzer betrachtet (d. h. .\localuser). |
IdentityUserName |
nein |
Der Benutzername, der als Identität des Anwendungspools verwendet wird. Ist er nicht definiert, werden die Parameter IdentityUserDomain und IdentityUserPassword ignoriert, und der Standardwert von IIS wird verwendet (das heißt ApplicationPoolIdentity). |
IdentityUserPassword |
nein |
Das Kennwort des Benutzers, der als Identität des Anwendungspools verwendet wird. |
Is32BitsAllowed |
nein |
Flag, um die Ausführung von 32-Bit-Anwendungen im Anwendungspool zuzulassen oder abzulehnen. Folgende Werte sind zulässig:
|
IsAutoStart |
nein |
Flag, das angibt, ob der Anwendungspool oder die Website automatisch beim Windows-Start gestartet werden soll. Folgende Werte sind zulässig:
|
IsPreloadEnabled |
nein |
Das Flag, das angibt, ob die Funktionalität "vorab laden" für eine Webseite oder Webanwendung aktiviert ist. Folgende Werte sind zulässig:
|
PhysicalPath |
Ja [Erstellungsaktion] Nein [alle anderen Aktionen für virtuelle Verzeichnisse, Websites und Webanwendungen] |
Der vollständige physische Pfad des virtuellen Verzeichnisses, der Website oder der Webanwendung. |
PipeLineMode |
nein |
Der verwaltete Pipelinemodus, der im Anwendungspool verwendet wird. Folgende Werte sind zulässig:
|
PortNumber |
Ja [nur Erstellungsaktion] |
Die Portnummer, die für eine neue oder geänderte Website verwendet werden soll. |
ProcessIdleTimeOut |
nein |
Die Zeit in Minuten, die sich ein Prozess im Anwendungspool im Leerlauf befinden kann. |
RecycleAfterMinutes |
nein |
Eine feste Zeitspanne in Minuten, nach der der Anwendungspool wieder verwendet wird. |
RecycleFixedTime |
nein |
Ein fester Zeitpunkt, an dem der Anwendungspool wieder angewendet wird. Das erforderliche Format lautet: HH:MM (z. B. 23:58 oder 01:23). |
RecycleKbMemory |
nein |
Die maximale Menge Arbeitsspeicher (in KB), die verwendet werden soll, bevor der Anwendungspool wiederverwendet wird. |
SiteName |
Ja [Websiteaktion] Nein [Aktion für virtuelle Verzeichnisse] |
Der Name der Website, die erstellt, konfiguriert, entfernt, gestartet oder beendet werden soll. [Websiteaktion] Der Name der Website, unter der sich das virtuelle Verzeichnis befindet. Wenn diese nicht definiert sind, wird die standardmäßige Website verwendet. [Aktion für virtuelle Verzeichnisse] |
StartMode |
nein |
Der Startmodus, der für den Anwendungspool verwendet wird. Folgende Werte sind zulässig:
|
VirtualDirectoryName |
ja |
Das ist der Name des virtuellen Verzeichnisses, das erstellt, konfiguriert oder entfernt werden soll. |
WebApplicationName |
nein |
Der Name der Webanwendung, in der sich das virtuelle Verzeichnis befindet. Ist dies nicht definiert, wird die Stammwebanwendung der Website verwendet. |
WebAppName |
ja |
Das ist der Name der Webanwendung, die konfiguriert, erstellt oder entfernt werden soll. |
WebSiteName |
Ja [Websiteaktion] Nein [Webanwendungsaktion] |
Der Name der Website, die konfiguriert, erstellt, entfernt, gestartet oder beendet werden soll. [Websiteaktion] Der Name der Website, unter der sich die Webanwendung befindet. Wenn diese nicht definiert sind, wird die standardmäßige Website verwendet. [Webanwendungsaktion] |
Erstellen oder Bearbeiten von INI-Dateien
Diese INI-Datei-Aktionen verwenden das Tool INI-Datei-Manager, um Abschnitte und Schlüssel in der Datei hinzuzufügen, zu ändern oder zu entfernen. Weitere Informationen über dieses Tool, wechseln Sie hier.
Aktion |
Beschreibung |
|---|---|
Schlüssel erstellen |
Erstellt einen neuen Schlüssel mit einem Wert in einem bestimmten Abschnitt einer INI-Datei. Wenn die angegebene Datei nicht vorhanden ist, wird sie von der Aktion erstellt. Wenn der angegebene Abschnitt nicht vorhanden ist, wird er von der Aktion erstellt. Wenn der Schlüssel bereits im angegebenen Abschnitt vorhanden ist, wird sein Wert von der Aktion ersetzt. |
Schlüssel bearbeiten |
Ändert einen vorhandenen Schlüssel in einem bestimmten Abschnitt einer INI-Datei. Wenn die angegebene Datei nicht vorhanden ist, wird sie von der Aktion erstellt. Wenn der angegebene Abschnitt nicht vorhanden ist, wird er von der Aktion erstellt. Wenn der Schlüssel bereits im angegebenen Abschnitt vorhanden ist, wird er von der Aktion hinzugefügt. |
Wert bearbeiten |
Ändert den Wert eines vorhandenen Schlüssels in einem bestimmten Abschnitt einer INI-Datei. Wenn die angegebene Datei nicht vorhanden ist, wird sie von der Aktion erstellt. Wenn der angegebene Abschnitt nicht vorhanden ist, wird er von der Aktion erstellt. Wenn der Schlüssel nicht im angegebenen Abschnitt vorhanden ist, wird er von der Aktion hinzugefügt. |
Schlüssel entfernen |
Entfernt einen Schlüssel und seine Werte aus einem bestimmten Abschnitt einer INI-Datei. Wenn die angegebene Datei nicht vorhanden ist, schlägt die Aktion fehl. Wenn der angegebene Abschnitt oder Schlüssel nicht vorhanden ist, wird die Aktion trotzdem ausgeführt. Wenn Sie angeben, dass alle Schlüssel aus einem Abschnitt entfernt werden sollen, wird auch der Abschnitt entfernt. |
Abschnitt bearbeiten |
Ändert den Namen des Abschnitts in einer INI-Datei. Wenn die angegebene Datei nicht vorhanden ist, wird sie von der Aktion erstellt. Wenn der angegebene Abschnitt nicht vorhanden ist, wird die Aktion trotzdem ausgeführt. |
Abschnitt entfernen |
Entfernt einen Abschnitt und alle seine Schlüssel und Werte innerhalb einer INI-Datei. Wenn die angegebene Datei nicht vorhanden ist, schlägt die Aktion fehl. Wenn der angegebene Abschnitt nicht vorhanden ist, wird die Aktion trotzdem ausgeführt. |
Konfigurationsvariablen
Parameter |
Erforderlich |
Beschreibung |
|---|---|---|
INIFile |
ja |
Der Name und Pfad der zu ändernden INI-Datei. |
KeyName |
ja |
Der Name des Schlüssels, der erstellt, bearbeitet oder entfernt werden soll. |
KeyValue |
nein |
Der neue Wert, der einem Schlüssel zugeordnet werden soll. Sofern dies nicht angegeben ist, aber NewKeyName angegeben ist, wird der tatsächliche Wert vom System verwendet. Sofern weder dies noch NewKeyName angegeben ist, wird der Wert geleert. |
NewKeyName |
nein |
Der neue Name, der einem Schlüssel zugeordnet werden soll. Sofern nichts angegeben wird, bleibt der Name des Schlüssels unverändert. |
NewSectionName |
nein |
Der neue Name, der einem Abschnitt zugewiesen werden soll. Sofern nicht anders angegeben, werden die Schlüssel des alten Abschnitts unter den Stammabschnitt gestellt (alle Schlüssel, die sich am Anfang der Datei befinden, bevor der erste Abschnitt im Stamm berücksichtigt wird). |
SectionName |
nein |
[Aktion zum Erstellen oder Ändern eines Schlüssels] Der Name des Abschnitts, in dem ein Schlüssel hinzugefügt oder geändert werden soll. Wird dies nicht angegeben, wird der Stammabschnitt aktualisiert. .gif "Hinweis") Hinweis
Alle Schlüssel, die sich am Anfang der Datei vor dem ersten Abschnitt befinden, werden als Stammabschnitt betrachtet.
[Umbenennungsaktion] Der Abschnitt, der umbenannt werden soll. Falls nicht angegeben, werden die Schlüssel des alten Abschnitts im Stammabschnitt platziert. [Entfernungsaktion] Der Abschnitt, der entfernt werden soll. Wird kein Abschnitt angegeben, wird der Stammabschnitt entfernt. |
SQL Server-Datenbanken verwalten
Diese Aktionen verwenden das Tool Datenbankbereitsteller – Skript ausführen, um eine SQL Server-Datenbank zu erstellen, zu löschen, zu sichern und wiederherzustellen. Weitere Informationen über dieses Tool, wechseln Sie hier.
Aktionen |
Beschreibung |
|---|---|
SQL-Datenbank erstellen |
Erstellt eine neue Datenbank. Falls die Datenbank bereits vorhanden ist, schlägt die Aktion fehl. |
SQL-Datenbank löschen |
Löscht eine Datenbank. Wenn die Datenbank nicht vorhanden ist, schlägt die Aktion fehl. |
SQL-Datenbank sichern |
Sichert eine vorhandene Datenbank in einem angegebenen Pfad. |
SQL-Datenbank wiederherstellen |
Stellt eine Datenbank aus einer angegebenen Quelle wieder her. |
Konfigurationsvariablen
Parameter |
Erforderlich |
Beschreibung |
|---|---|---|
DatabaseName |
ja |
Der Name der SQL Server-Datenbank, die erstellt, gelöscht, gesichert oder wiederhergestellt werden soll. |
Path |
ja |
Der Pfad und Dateiname, unter dem die Datenbanksicherung gespeichert werden soll. Beispiel: \\server\filename.bak. |
ServerName |
ja |
Der Name des Servers, auf dem die SQL-Datenbank erstellt, gesichert, wiederhergestellt oder gelöscht werden soll. |
Source |
ja |
Der Pfad und der Dateiname der Datenbanksicherung, die wiederhergestellt werden soll. |
Einrichten der Server
Diese Aktionen können verwendet werden, um den Servercomputer einzurichten, wenn auf ihm ein Windows-Betriebssystem ausgeführt wird. Sie können Befehle ausführen und Prozesse beenden sowie Dateien, Ordner, Umgebungsvariablen und Windows-Registrierungsschlüssel und -werte verwalten. Das System führt diese Aktionen mit einer Reihe vordefinierter Releaseverwaltungstools aus, einschließlich Befehlszeilenausführung, Windows-Prozess und XCopy-Bereitsteller. Ausführliche Informationen zu diesen Tools, wechseln Sie hier.
Aktion |
Hinweise und mögliche Gründe für Bereitstellungsfehler |
|---|---|
|
Verwenden Sie Befehlszeile ausführen, um einen Befehl mit der Deployment Agent-Identität auszuführen. Verwenden Sie Befehlszeile als Benutzer ausführen, um einen Befehl mit bestimmten Benutzeranmeldeinformationen auszuführen. |
|
Diese Aktionen unterstützen das Erstellen, Ändern und Löschen von Dateien, Ordnern und das Auswählen von Attributen. Wenn Sie Dateien oder Ordner erstellen, wird auch jedes nicht vorhandene übergeordnete Verzeichnis des Ordners erstellt. |
|
Diese Aktionen unterstützen das Erstellen, Ändern und Löschen von Umgebungsvariablen. |
|
Diese Aktionen unterstützen das Erstellen, Ändern und Löschen von Registrierungsschlüsseln und -werten. Die Bereitstellungssequenz schlägt nur fehl, wenn Sie versuchen, einen Registrierungsschlüssel zu ändern, der nicht vorhanden ist. |
Konfigurationsvariablen zum Ausführen von Befehlen oder Beenden von Prozessen
Parameter |
Erforderlich |
Beschreibung |
|---|---|---|
Arguments |
nein |
Die Argumente, die für das Ausführen der Befehlszeile erforderlich sind. |
command |
ja |
Fester Wert: ./WindowsProcess.ps1. |
FilePath |
nein |
Die Domäne des Benutzers, der als Identität des Anwendungspools auftritt. Ist er nicht definiert, und IdentityUserName ist definiert, wird der Benutzer als lokaler Benutzer betrachtet (d. h. .\localuser). |
IsKillProcessTree |
nein |
Gibt an, ob die Prozessstruktur beendet werden soll. Folgende Werte sind zulässig:
|
ProcessName |
ja |
Der Name des aufzuhebenden Windows-Prozesses. |
UserDomain |
nein |
Die Domäne des zum Ausführen der ausführbaren Datei verwendeten Benutzers. Ist dies nicht angegeben, wird "\localuser" zugewiesen. |
UserName |
Ja [Aktion zum Ausführen von Befehl] Nein [Aktion zum Beenden des Prozesses] |
Der Name des zum Ausführen der ausführbaren Datei verwendeten Benutzers. Das den Prozess ausführende Benutzerkonto. Sofern nicht angegeben, wird der Prozess für alle Benutzer aufgehoben. |
UserPassword |
nein |
Das Kennwort des zum Ausführen der ausführbaren Datei verwendeten Benutzers. |
Konfigurationsvariablen zum Verwalten von Dateien und Ordnern
Parameter |
Erforderlich |
Beschreibung |
|---|---|---|
Archive |
nein |
Hiermit wird das Archivattribut für Dateien oder Ordner festgelegt oder zurückgesetzt.
|
DestinationFileFolder |
Die .NET Framework-Version, die für den Anwendungspool verwendet wird. Dieser Parameter ist nur für IIS 7.5, 8.0 und 8.5 zulässig. Die folgenden Werte sind zulässig: v1.0, v1.1, v2.0 oder v4.0. |
|
DestinationName |
ja |
Der Zielpfad, in den Dateien oder Ordner kopiert oder verschoben werden. Oder der neue Name, in den die Datei oder der Ordner umbenannt werden soll. |
FileFolderName |
ja |
Die Quelldateien oder Quellordner, die gelöscht, geändert, verschoben oder umbenannt werden sollen. Für die Löschaktion können Sie Platzhalter verwenden, beispielsweise c:, temp oder *.log. |
FolderName |
ja |
Der Name des Ordners und der Pfad, die erstellt werden sollen. |
Hidden |
nein |
Legt das Attribut "Ausgeblendet" für Dateien oder Ordner fest oder setzt es zurück.
|
OwnerDomain |
nein |
Domäne des neuen Besitzers der Dateien oder Ordner. Ist dies nicht angegeben, wird "\localuser" zugewiesen. |
OwnerDomain |
ja |
Der Name des neuen Besitzers der Dateien oder Ordner. |
ReadOnly |
Legt das Attribut "Schreibgeschützt" für Dateien oder Ordner fest oder setzt es zurück.
|
|
SourceFileFolder |
ja |
Die zu kopierenden Quelldateien oder -ordner. Sie können Platzhalter verwenden, beispielsweise c:, temp oder *.log. |
System |
Hiermit wird das Systemattribut für Dateien oder Ordner festgelegt oder zurückgesetzt.
|
Konfigurationsvariablen für Umgebungsvariablenaktionen
Parameter |
Erforderlich |
Beschreibung |
|---|---|---|
VariableName |
ja |
Der Name der zu erstellenden, zu ändernden oder zu löschenden Variable. |
VariableValue |
nein |
Der Wert, der der hinzugefügten bzw. geänderten Variablen zugeordnet werden soll. Wenn kein Wert festgelegt wird, werden die Variablen gelöscht. |
Konfigurationsvariablen für Windows-Registrierungsaktionen
Parameter |
Erforderlich |
Beschreibung |
|---|---|---|
NewRegistryKey |
ja |
Der vollständige Name des Zielregistrierungsschlüssels, beispielsweise HKLM, Software oder NEWKEY. |
OperatingSystemType |
nein |
Der Betriebssystemtyp, in dem der Registrierungsschlüssel erstellt wird. Folgende Werte sind zulässig:
|
RegistryData |
nein |
Die an den Registrierungswert zu übergebenden Daten. |
RegistryKey |
ja |
Der vollständige Name des Registrierungsschlüssels, der erstellt, geändert oder gelöscht werden soll. Beispielsweise HKLM, Software oder NEWKEY. |
RegistryValue |
ja |
Der Name des hinzuzufügenden oder zu ändernden Registrierungswerts. |
ValueType |
nein |
Der Datentyp des Registrierungswerts. Folgende Werte sind zulässig:
|
Verwalten von Windows-Diensten
Diese Aktionen verwenden das vordefinierte Tool Windows-Dienst-Manager, um einen Windows-Dienst zu erstellen, zu konfigurieren, zu löschen, neu zu starten, zu starten und zu beenden. Weitere Informationen über dieses Tool, wechseln Sie hier.
Aktion |
Verwendung und mögliche Gründe für Bereitstellungsfehler |
|---|---|
|
Verwenden Sie Dienst erstellen, um einen neuen Dienst zu erstellen. Die Bereitstellungssequenz schlägt fehl, wenn der Dienst bereits vorhanden ist. Verwenden Sie Dienst konfigurieren, um einen vorhandenen Dienst zu konfigurieren. Die Bereitstellungssequenz schlägt fehl, wenn der Dienst nicht vorhanden ist. Verwenden Sie Anmeldeinformationen für Dienst konfigurieren, um einen vorhandenen Dienst mit neuen Anmeldeinformationen zu konfigurieren. Die Bereitstellungssequenz schlägt fehl, wenn der Dienst nicht vorhanden ist. Außerdem schlägt die Bereitstellungssequenz fehl, wenn der angegebene ServiceName-Parameter nicht vorhanden ist, und Sie angeben, dass der Dienst gestartet, beendet oder neu gestartet werden soll. Sie schlägt nicht fehl, wenn der Dienst bereits gestartet oder beendet wurde. |
Konfigurationsvariablen
Parameter |
Erforderlich |
Beschreibung |
|---|---|---|
BinPath |
nein |
Der Binärpfad und der Name des Diensts. |
Description |
ja |
Beschreibung des zu konfigurierenden oder zu erstellenden Diensts. |
DisplayName |
nein |
Name des zu konfigurierenden oder zu erstellenden Diensts. |
Password |
nein |
Das Kennwort des zum Starten des Diensts angegebenen Benutzernamens. |
ServiceName |
ja |
Der Name des Diensts, der erstellt, konfiguriert, gelöscht, wiederverwendet, gestartet oder beendet werden soll. |
StartMode |
nein |
Startmodus des Diensts. Folgende Werte sind zulässig:
|
UserName |
ja |
Benutzername, der zum Starten des Diensts verwendet werden soll. Verwenden Sie das Format DOMÄNE\BENUTZER, beispielsweise NT AUTHORITY\NETWORK SERVICE. Wenn Sie UserName angeben, müssen Sie auch Password angeben. Um die Anmeldeinformationen auf "LocalSystem" zurückzusetzen, geben Sie LocalSystem als Benutzer und zwei Anführungszeichen ("") als Kennwort ein. |