Narzędzia Release Management do wdrażania aplikacji

Każda akcja wydania używa narzędzia zarządzania wydaniem.Na przykład, Command Line Runner to narzędzie, które uruchamia określony plik wykonywalny dla danej akcji.Aby wykonać zadanie, którego nie obsługują dostarczone narzędzia, należy stworzyć własne narzędzie niestandardowe i dodać je do niestandardowej akcji wydania.Narzędzia można również wykorzystywać do wdrażania składnika aplikacji.

Oto lista narzędzi dostarczanych z Release Management, wraz z ich parametrami:

Agent wdrażania bazy danych — Wykonanie skryptu

To narzędzie wykonuje kwerendę SQL na określonej bazie danych.Narzędzie jest oparte na standardowym pliku wykonywalnym sqlcmd, rozpowszechnianym z SQL Server.Zapoznaj się z dokumentacją sqlcmd, aby uzyskać więcej informacji na temat tego pliku wykonywalnego.Zmienne konfiguracji dla tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-S	ServerName	Tak	Nazwa serwera bazy danych SQL.
-i	ScriptName	Tak	Nazwa skryptu do wykonania.
-b	Nie dot.	Nie	Ten parametr to przełącznik.Jeśli jest obecny, oznacza to, że w przypadku wystąpienia błędu zadanie wsadowe zostanie przerwane.

Agent wdrażania usług raportowania

To narzędzie służy do wdrażania raportów usług raportowania i powiązanych obiektów.Narzędzie jest oparte na niestandardowej wersji pliku wykonywalnego zarządzania.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-s	serverUrl	Tak	Pełny adres URL serwera usług raportowania.
-l	itemLocation	Tak, jeśli wiele elementów	Lokalizacja elementów.Jeśli określona, należy podać folder (-f).
-f	folder	Tak, jeśli wiele elementów	Folder z elementami.Jeśli określony, należy podać lokalizację elementu (-l).
-t		Tak	Typ elementu do przetworzenia.Dozwolone wartości to: Raport Obraz
-sp		Nie	Wykaz wzorców wyszukiwania używany do filtrowania elementów.Każdy wzorzec wyszukiwania musi być oddzielony przecinkiem lub średnikiem (na przykład *.bmp;*.jpg).Jeśli nie zostanie określony, wzorzec wyszukiwania będzie następujący, zgodnie z typem wybranego elementu (-t): Raport: *.rdl Obraz: *.bmp,*.gif,*.jpg,*.jpeg,*.png
-i		Tak, jeśli pojedyncze elementy	Plik elementu.Jeśli określony, należy podać nazwę elementu (-n).Ten parametr jest używany, gdy należy wdrożyć pojedynczy element.Jeśli tak, parametry lokalizacji elementu (-l) i folderu elementu (-f) nie mogą być obecne.
-n		Tak, jeśli pojedyncze elementy	Nazwa elementu.Jeśli określony, należy podać plik elementu (-i).Ten parametr jest używany, gdy należy wdrożyć pojedynczy element.Jeśli tak, parametry lokalizacji elementu (-l) i folderu elementu (-f) nie mogą być obecne.
-log		Nie	Zostanie wygenerowany plik dziennika o podanej nazwie w katalogu fizycznym.
-o	Nie dot.	Nie	Ten parametr to przełącznik.Jeśli jest obecny, oznacza to, że miejsce docelowe zostanie zastąpione, jeśli już istnieje.
-ds ds1,...,dsN			Rozdzielana przecinkami, w pełni kwalifikowana nazwa wszystkich źródeł danych do skojarzenia z elementem.Uwzględniana jest wielkość liter.Ta opcja dotyczy tylko raportów.Źródło danych może być podane w formacie [nazwa:] odniesienie.Nazwa jest nazwą źródła danych określonego w raporcie, gdzie mają zostać zastąpione odniesienia.Odwołanie to w pełni kwalifikowane odwołanie do źródła danych na serwerze docelowym do użycia w raporcie.

Agent wdrażania MSI

Narzędzie to wdraża plik MSI.Odinstalowuje poprzednią instalację produktu przed rozpoczęciem nowej instalacji.Narzędzie jest oparte na niestandardowej wersji skryptu PowerShell.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-command	Nie dot.	Tak	Stała wartość ./msiexec.ps1.
-MsiFileName	Instalator	Tak	Pełna ścieżka (w razie potrzeby) i nazwa pliku .msi do instalacji.
-MsiCustomArgs	MsiCustomArgs	Nie	Niestandardowe argumenty do użycia w celu instalacji pliku .msi.Te argumenty zostaną przekazane bezpośrednio do pliku wykonywalnego msiexec.Jeśli argumenty niestandardowe nie są wymagane, parametr musi zostać usunięty z argumentów.
-PrevProductName		Nie	Pozwala użytkownikowi na określenie poprzedniej nazwy produktu do odinstalowania przed zainstalowaniem pliku .msi.Domyślnie system użyje nazwy produktu w pliku .msi do zainstalowania.

Agent wdrażania XCopy

To narzędzie kopiuje lokalizację pakietu do określonego miejsca docelowego.Narzędzie jest oparte na niestandardowej wersji skryptu wsadowego.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-source	Nie dot.	Tak	Stała wartość wskazująca, że wszystkie lokalizacje źródłowe muszą zostać skopiowane
-destination	Ścieżka instalacji	Tak	Miejsce docelowe kopii instalacji.

Command Line Runner

To narzędzie uruchamia określony plik wykonywalny.Narzędzie jest oparte na niestandardowej wersji skryptu PowerShell.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-file	Nie dot.	Tak	Wartość stałej. / RunCommandLine.ps1.
-FilePath	FilePath	Tak	Pełna ścieżka (w razie potrzeby) i nazwa pliku wykonywalnego do uruchomienia.
-Arguments	Argumenty	Nie	Argumenty wymagane przy uruchamianiu pliku wykonywalnego.
-UserDomain	UserDomain	Nie	Domena użytkownika do użycia w przypadku, gdy plik wykonywalny musi być uruchamiany w kontekście określonej tożsamości.Jeśli nie podano, zostanie użyta użytkownika lokalnego (.\localuser).
-UserName	UserName	Nie	Nazwa użytkownika do użycia w przypadku, gdy plik wykonywalny musi być uruchamiany w kontekście określonej tożsamości.
-UserPassword	UserPassword	Nie	Hasło użytkownika do użycia w przypadku, gdy plik wykonywalny musi być uruchamiany w kontekście określonej tożsamości.

Menedżer rejestru systemu Windows

To narzędzie obsługuje informacje rejestru w systemie Windows.Narzędzie jest oparte na niestandardowej wersji skryptu PowerShell.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-command	Nie dot.	Tak	Stała wartość ./ManageWindowsRegistry.ps1.
-Action	Akcja	Tak	Akcja do wykonania.Dozwolone wartości to: CreateKey: Tworzenie nowego klucza rejestru ModifyKey: Modyfikowanie klucza rejestru lub jego danych DeleteKey: Usuwanie klucza rejestru ze wszystkimi jego wartościami i kluczami podrzędnymi CreateValue: Tworzenie nowej wartości rejestru znajdującej się w kluczu ModifyValue: Modyfikacja wartości rejestru znajdującej się w kluczu DeleteValue: Usuwanie wartości rejestru znajdującej się w kluczu
-OperatingSystemType		Nie	Wskazuje, czy klucz / wartość są dostępne w rejestrze 32-bitowym, czy 64-bitowym.Jeśli nie zostały podane, wartością domyślną jest 32-bitowy.
-RegistryKey	RegistryKey	Tak	Ścieżka i nazwa klucza rejestru (na przykład HKLM\Software\MyKey).
-RegistryValue		Nie*	Wartość rejestru, do której zastosowane zostaną zmiany (na przykład MyValue).Wymagane dla CreateValue, ModifyValue i DeleteValue.
-ValueType		Nie	Typ uwzględnianej wartości.Dozwolone wartości to: REG_SZ: Ciąg (wartość domyślna, jeżeli nie określono) REG_QWORD_LITTLE_ENDIAN: Wartość liczby 64-bitowej w formacie little-endian REG_QWORD: Wartość liczby 64-bitowej REG_NONE : Brak wartości REG_MULTI_SZ: Ciąg wielowierszowy (oddzielony \0) REG_LINK: Dowiązanie symboliczne REG_EXPAND_SZ: Ciąg znaków z nierozwiniętymi odwołaniami do zmiennych środowiskowych REG_DWORD_BIG_ENDIAN : Wartość liczby 32-bitowej w formacie big-endian REG_QWORD_LITTLE_ENDIAN : Wartość liczby 32-bitowej w formacie little-endian REG_DWORD: Wartość liczby 32-bitowej REG_BINARY: Dane binarne w dowolnej formie
-RegistryData		Nie	Dane dotyczą albo wartości (w przypadku użycia CreateValue lub ModifyValue), albo wartości domyślnej klucza (w przypadku użycia CreateKey lub ModifyKey).
-RegistryKeyDestination		Nie*	Nazwa klucza rejestru używana przy wykorzystaniu akcji ModifyKey do zmiany nazwy klucza rejestru.Na przykład: RegistryKey = HKLM\Software\MyKey RegistryKeyDestination = HKLM\Software\MyModifiedKey wymagane dla ModifyKey.

Windows Common IO

Narzędzie wykonuje typowe operacje We/Wy w systemie Windows.Narzędzie jest oparte na niestandardowej wersji skryptu PowerShell.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-command	Nie dot.	Tak	Stała wartość ./ManageWindowsIO.ps1.
-Action	Akcja	Tak	Wskazuje działanie do wykonania: Utwórz : Utworzenie nowego folderu. Usuń: Usunięcie plików lub folderów Zmień nazwę: Zmiana nazwy pliku lub folderu Przenieś: Przenoszenie pliku lub folderu Atrybuty: Modyfikowanie atrybutów (w tym własności) plików lub folderów
-FileFolderName	FileFolderName	Tak	Ścieżka i nazwa pliku lub folderu.
-DestinationName		Nie*	Nazwa docelowego (w przypadku zmiany nazwy akcji) lub ścieżka folderu i nazwę (Przenieś akcji). Wymagane dla akcji zmiany nazwy i przenoszenia.
-ReadOnly		Nie	Pozwala użytkownikowi na ustawianie lub resetowanie atrybutu tylko do odczytu dla plików lub folderów. + : Ustaw flagę - : Resetuj flagę Jakakolwiek inna wartość : Zostaw flagę bez zmian
-Archive		Nie	Pozwala użytkownikowi na ustawianie lub resetowanie atrybutu archiwalny dla plików lub folderów. + : Ustaw flagę - : Resetuj flagę Jakakolwiek inna wartość : Zostaw flagę bez zmian
-System		Nie	Pozwala użytkownikowi na ustawianie lub resetowanie atrybutu systemowy dla plików lub folderów. + : Ustaw flagę - : Resetuj flagę Jakakolwiek inna wartość : Zostaw flagę bez zmian
-Hidden		Nie	Pozwala użytkownikowi na ustawianie lub resetowanie atrybutu ukryty dla plików lub folderów. + : Ustaw flagę - : Resetuj flagę Jakakolwiek inna wartość : Zostaw flagę bez zmian
-OwnerDomain		Nie	Reprezentuje domenę nowego właściciela dla pliku lub folderu.
-OwnerName		Nie	Reprezentuje nazwę nowego właściciela dla pliku lub folderu.

Windows Service Manager

To narzędzie umożliwia zarządzanie usługami systemu Windows.Narzędzie jest oparte na niestandardowej wersji skryptu PowerShell.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-command	Nie dot.	Tak	Stała wartość ./ManageWindowsServices.ps1.
-Action	Akcja	Tak	Wskazuje działanie do wykonania: Create : Utworzenie nowej usługi Config : Konfigurowanie istniejącej usługi Delete: Usunięcie istniejącej usługi Start: Rozpoczęcie usługi Stop : Zatrzymanie usługi Restart: Zatrzymanie i uruchomienie usługi
-ServiceName	ServiceName	Tak	Nazwa usługi.
-ServerName		Nie	Nazwa serwera, gdzie będzie można wykonać tę akcję.Jeśli nie zostanie określona, użyty zostanie bieżący serwer.
-BinPath		Nie*	Ścieżka binarna i nazwa usługi.Wymagane dla akcji Create, fakultatywne dla akcji Config i ignorowane przez wszystkie inne.
-DisplayName		Nie	Wyświetlana nazwa, która będzie używana dla tej usługi.Fakultatywne dla akcji Create i Config oraz ignorowane przez wszystkie inne.
-Description		Nie	Opis, który zostanie przydzielony do usługi.Fakultatywne dla akcji Create i Config oraz ignorowane przez wszystkie inne.
-UserName		Nie	Nazwa użytkownika, która będzie używana dla poświadczeń do uruchomienia usługi (musi być w postaci DOMENA\UŻYTKOWNIK).Jeśli podana, należy również podać parametr –Password.Jeśli nie podano, domyślnie używane będzie konto LocalSystem.Fakultatywne dla akcji Create i Config oraz ignorowane przez wszystkie inne. Aby przywrócić poświadczenia LocalSystem, wprowadź LocalSystem jako użytkownika i "" jako hasło.
-Password		Nie	Hasło dla nazwy użytkownika do uruchomienia usługi.Fakultatywne dla akcji Create i Config oraz ignorowane przez wszystkie inne.
-StartMode		Nie	Tryb uruchamiania usługi.Domyślnie dla utworzonej usługi wybrany zostanie tryb automatyczny.Dostępne są następujące opcje: Ręczny: Usługa jest uruchomiona tylko ręcznie Automatyczny : Usługa zostanie uruchomiona automatycznie po ponownym uruchomieniu komputera Disabled: Usługa jest wyłączona Fakultatywne dla akcji Create i Config oraz ignorowane przez wszystkie inne.

Agent wdrażania bazy danych DACPAC

To narzędzie służy do wdrażania pakietu DACPAC.Narzędzie jest oparte na narzędziu wiersza polecenia systemu SQL Server.Istnieje wiele możliwych parametrów dla tego pliku wykonywalnego, ale poniżej znajduje się lista parametrów, które są używane dla danego narzędzia.Zapoznaj się z Narzędziem wiersza polecenia pakietu SQL w celu uzyskania dodatkowych informacji.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
/Action:		Tak	Stała wartość: Publish – określa, że pakiet zostanie opublikowany.
/SourceFile:	FileName	Tak	Pełna ścieżka (w razie potrzeby) i nazwa pliku pakietu DACPAC.
/TargetServerName:	ServerName	Tak	Nazwa serwera SQL do opublikowania pakietu.
/TargetDatabaseName:	DatabaseName	Tak	Nazwa bazy danych SQL Server do opublikowania pakietu.

Agent wdrażania IIS

To narzędzie obsługuje obiekty i ustawienia IIS.Narzędzie jest oparte na niestandardowej wersji pliku wykonywalnego zarządzania.Zmienne konfiguracji tego narzędzia różnią się w zależności od rodzaju akcji do wykonania.

Dla działań puli aplikacji:

Parametr	Zmienna	Obowiązkowa	Opis
-Action		Tak	Wskazuje działanie do wykonania: CreateApplicationPool ConfigureApplicationPool DropApplicationPool StartApplicationPool StopApplicationPool RecycleApplicationPoo
-ap		Tak	Nazwa puli aplikacji.
-apAllow32Bit		Nie	Flaga wskazująca, czy pula aplikacji dopuszcza aplikacje 32-bitowe.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.Dozwolone wartości to: 1 lub True: aplikacje 32-bitowe są dozwolone 0 lub False: aplikacje 32-bitowe nie są dozwolone
-apIdentUserDomain		Nie	Domena użytkownika do użycia jako tożsamość puli aplikacji.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.Jeśli nie zdefiniowano i "IdentityUserName" jest zdefiniowana, użytkownik będzie uważane za użytkownika lokalnego (.\localuser).
-apIdentUserName		Nie	Nazwa użytkownika do użycia jako tożsamość puli aplikacji.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.Jeśli nie zostanie zdefiniowany, wartości "IdentityUserDomain" i "IdentityUserPassword" zostaną zignorowane, a wartość domyślna usługi IIS będzie używana (ApplicationPoolIdentity).
-apIdentUserPassword		Nie	Hasło użytkownika do użycia jako tożsamość puli aplikacji.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.
-apNetVers		Nie	Wersja środowiska .NET Framework dla puli aplikacji.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.Dozwolone wartości to: v1.0, v1.1, v2.0, v4.0
-apPipelineMode		Nie	Tryb zarządzanego potoku do użycia w puli aplikacji.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.Dozwolone wartości to: Klasyczny Zintegrowany
-apProcessIdleTimeout		Nie	Liczba minut, przez jaką proces może być bezczynny w puli aplikacji.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.
-apRecycleKbMemory		Nie	Maksymalna ilość KB pamięci do wykorzystania, zanim pula aplikacji zostanie odtworzona.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.
-apRecycleMinutes		Nie	Ustalona liczba minut, po których upływie pula aplikacji zostanie odtworzona.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.
- apRecycleSpecificTime		Nie	Stały czas, po którego upływie pula aplikacji zostanie odtworzona.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.Wymagany format to GG:MM (na przykład 23:58 lub 01:23).
-apStartMode		Nie	Tryb uruchamiania, który ma być używany dla puli aplikacji.Ten parametr jest dozwolony tylko dla usług IIS 8.0 i 8.5.Dozwolone wartości to: Na żądanie Zawsze włączony
-AutoStart		Nie	Flaga wskazująca, że pula aplikacji musi być uruchamiana automatycznie.Ten parametr jest dozwolony tylko dla usług IIS 7.0, 7.5, 8.0 i 8.5.Dozwolone wartości to: 1 lub True: Pula aplikacji będzie uruchamiana automatycznie podczas uruchamiania systemu Windows. 0 lub False: Pula aplikacji nie będzie uruchamiana automatycznie podczas uruchamiania systemu Windows.
-log		Nie

Dla akcji witryny sieci Web:

Parametr	Zmienna	Obowiązkowa	Opis
-Action		Tak	Wskazuje działanie do wykonania: CreateWebSite ConfigureWebSite DropWebSite StartWebSite StopWebSite RestartWebSite
-sn		Tak	Nazwa witryny sieci Web.
-port		Nie*	Numer portu witryny sieci Web.Wymagany w przypadku akcji tworzenia i opcjonalny dla akcji konfigurowania.
-pd		Nie*	Pełna ścieżka routingu do lokalizacji, gdzie aplikacja została opublikowana.Wymagany w przypadku akcji tworzenia i opcjonalny dla akcji konfigurowania. Uwaga Upewnij się, że nie jest brak ukośnika ścieżki.
-ap		Nie	Nazwa puli aplikacjiJeśli nie została zdefiniowana podczas tworzenia puli aplikacji, użyta zostanie domyślna pula aplikacji.Opcjonalnie w akcjach Utwórz i Konfiguruj.
-EnablePreload		Nie	Dozwolone dla usług IIS 7.0, 7.5, 8.0 i 8.5.Flaga wskazująca, czy witryny sieci Web muszą zostać wstępnie załadowane.Opcjonalnie w akcjach Utwórz i Konfiguruj.Dozwolone wartości to: 1 lub True: Wstępne załadowanie włączone 0 lub False: Wstępne załadowanie wyłączone
-AutoStart		Nie	Dozwolone dla usług IIS 7.0, 7.5, 8.0 i 8.5.Flaga wskazująca, że witryna sieci Web musi być uruchamiana automatycznie.Opcjonalnie w akcjach Utwórz i Konfiguruj.Dozwolone wartości to: 1 or True: Uruchamiana automatycznie 0 lub False: Nieuruchamiana automatycznie
-log		Nie	Zostanie wygenerowany plik dziennika o podanej nazwie w katalogu fizycznym.

Dla akcji aplikacji sieci Web:

Parametr	Zmienna	Obowiązkowa	Opis
-Action		Tak	Wskazuje działanie do wykonania: CreateWebApplication ConfigureWebApplication DropWebApplication
-ws		Tak	Nazwa aplikacji do utworzenia.
-pd		Nie*	Pełna ścieżka routingu do lokalizacji, gdzie aplikacja została opublikowana.Wymagany w przypadku akcji tworzenia i opcjonalny dla akcji konfigurowania.
-sn		Nie	Nazwa witryny sieci Web.Jeśli nie jest określona, system użyje domyślnej witryny sieci Web podczas tworzenia nowej aplikacji.Opcjonalnie w akcjach Utwórz i Konfiguruj.
-ap		Nie	Nazwa puli aplikacjiJeśli nie została zdefiniowana podczas tworzenia puli aplikacji, użyta zostanie domyślna pula aplikacji.Opcjonalnie w akcjach Utwórz i Konfiguruj.
-EnablePreload		Nie	Dozwolone dla usług IIS 7.0, 7.5, 8.0 i 8.5.Flaga wskazująca, czy witryny sieci Web muszą zostać wstępnie załadowane.Opcjonalnie w akcjach Utwórz i Konfiguruj.Dozwolone wartości to: 1 lub True: Wstępne załadowanie włączone 0 lub False: Wstępne załadowanie wyłączone
-log		Nie	Zostanie wygenerowany plik dziennika o podanej nazwie w katalogu fizycznym.

Akcje dla katalogu wirtualnego:

Parametr	Zmienna	Obowiązkowa	Opis
-Action		Tak	Wskazuje działanie do wykonania: CreateVirtualDirectory ConfigureVirtualDirectory DropVirtualDirectory
-vd		Tak	Nazwa katalogu wirtualnego.
-pd		Nie*	Pełna ścieżka katalogu wirtualnego.Wymagany w przypadku akcji tworzenia i opcjonalny dla akcji konfigurowania.
-sn		Nie	Nazwa witryny sieci Web.Jeśli nie jest określona, system użyje domyślnej witryny sieci Web podczas tworzenia nowej aplikacji.Opcjonalnie w akcjach Utwórz i Konfiguruj.
-ws		Nie	Nazwa aplikacji sieci Web.Jeśli nie jest określona, system użyje podstawowej aplikacji sieci Web podczas tworzenia katalogu wirtualnego.Opcjonalnie w akcjach Utwórz i Konfiguruj.
-log		Nie	Zostanie wygenerowany plik dziennika o podanej nazwie w katalogu fizycznym.

Menedżer wirtualna Microsoft Azure

To narzędzie zarządza VM w Microsoft Azure.Narzędzie jest oparte na niestandardowej wersji skryptu PowerShell.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-command	Nie dot.	Tak	Stała wartość ./ControlAzureVM.ps1.
-Command		Tak	Wskazuje działanie do wykonania: Start: Rozpoczyna VM Stop: Zatrzymuje VM
-ServiceName	ServiceName	Tak	Nazwa usługi Microsoft Azure, w których istnieje VM.
-Name	Nazwa	Tak	Nazwa Microsoft Azure VM.

Narzędzie wdrażania XBAP

Narzędzie to służy do wdrażania aplikacji XBAP.Narzędzie jest oparte na niestandardowej wersji pliku wykonywalnego zarządzania.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-pn	ProjectName	Tak	Nazwa projektu XBAP do wdrożenia.
-d	Ścieżka instalacji	Tak	Ścieżka instalacji dla aplikacji XBAP.
-ml		Nie	Pełna ścieżka do pliku wykonywalnego narzędzia mag.Jeśli nie zostanie zdefiniowana, narzędzie będzie używać dostarczanej ścieżki jako zasobu narzędzia.
-pl		Nie	Pełna ścieżka, w której znajduje się projekt XBAP do wdrożenia.Jeśli nie zostanie określony, narzędzie użyje lokalizacji pakietu, gdzie jest wykonywana.
-url		Nie	Jeśli określony, system zamieni adres URL pliku setup.exe na podany.
-cf		Nie	Jeśli określony, to posłuży jako nazwa certyfikacji podczas aktualizowania manifestu.
-pwd		Nie	Jeśli określony, to posłuży jako hasło certyfikacji podczas aktualizowania manifestu.
-log		Nie	Zostanie wygenerowany plik dziennika o podanej nazwie w katalogu fizycznym.

Narzędzie wiersza polecenia Microsoft Test Manager (MTM)

To narzędzie tworzy i uruchamia zautomatyzowane testy wykorzystujące MTM (Microsoft Test Manager).Narzędzie jest oparte na niestandardowej wersji skryptu PowerShell.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-command	Nie dot.	Tak	Stała wartość ./TcmExec.ps1.
-Title	TestRunTitle	Tak	Nazwa, która będzie używana podczas tworzenia testowego uruchomienia.
-PlanId	PlanId	Tak	Identyfikator planu testu, pod którym należy uruchomić testy (unikatowy identyfikator, zgodnie z definicją w Test Manager).
-SuiteId	SuiteId	Tak	Identyfikator zestawu, który ma zostać uruchomiony (unikatowy identyfikator, zgodnie z definicją w Test Manager).
-ConfigId	ConfigId	Tak	Identyfikator konfiguracji testu, pod którym należy uruchomić testy (unikatowy identyfikator, zgodnie z definicją w Test Manager).
-Collection	TFSCollection	Tak	Adres URL kolekcji Team Foundation Server, dla którego wykonane zostaną testy automatyczne.
-TeamProject	TeamProject	Tak	Nazwa zespołu projektu, w którym zostały skonfigurowane zautomatyzowane testy.
-TestEnvironment	TestEnvironment	Tak	Środowisko testowe, w którym mają być wykonane testy (środowisko testowe jest skojarzone z odpowiednim kontrolerem testu).
-BuildDirectory	BuildDirectory	Nie*	Lokalizacja zautomatyzowanych testów.W programie MTM 2010, ten parametr jest wymagany.W programie MTM 2012 czy 2013, ten parametr jest nadal obsługiwany, ale użytkownicy powinni używać parametrów BuildDefinition i BuildNumber.
-BuildDefinition		Nie*	Zezwala użytkownikowi na określenie definicji kompilacji, w której zawarte są testy automatyczne.Tego parametru należy używać tylko z MTM 2012.Jeśli zdefiniowane, parametr BuildNumber również musi być określony.Jeśli nie jest określony, test uruchomienia nie wpłynie na pole "kompilacja" widoczne w obszarze szczegółów testu uruchomienia.
-BuildNumber		Nie*	Zezwala użytkownikowi na określenie numeru kompilacji, którego lokalizacja upuszczenia będzie zawierać zautomatyzowane testy.Tego parametru należy używać tylko z poziomu MTM 2012.Jeśli zdefiniowane, parametr BuildDefinition również musi być określony.Jeśli nie jest określony, test uruchomienia nie wpłynie na pole "kompilacja" widoczne w obszarze szczegółów testu uruchomienia.
-SettingsName		Nie	Zezwala użytkownikowi na określenie ustawień dla wykonywania badania.Jeśli nie zostanie określone, użyte zostaną domyślne ustawienia testu.
-TestRunWaitDelay		Nie	Zezwala użytkownikowi na określenie opóźnienia w sekundach między każdym wywołaniem kontrolera testuJest to wymagane, aby uruchomienie testowe mogło się zakończyć, zanim rozpocznie się przetwarzanie wyników testu.Jeśli nie jest określony, domyślnie będzie to 10 sekund.
-InconclusiveFailsTests	Nie dot.	Nie	Jeśli ta flaga będzie ustawiona, istnienie testów o niejednoznacznych wynikach spowoduje błąd wdrażania.Domyślnie, niejednoznaczny test nie zakończy się niepowodzeniem wdrażania.
-RemoveIncludeParameter	Nie dot.	Nie	Jeśli ta flaga będzie ustawiona, parametr /include nie zostanie dołączony do polecenia tworzenia testu.Oznacza to, że żadne testy, które mają stan inny niż Aktywny, nie będą umieszczane w uruchomieniu testowym.

Jeśli testy automatyczne są uwzględniane w tym samym procesie kompilacji, co wdrażana aplikacja, możliwe staje się wykorzystanie metadanych jako wartości zmiennej, która zostanie automatycznie zastąpiona w momencie wydania.Poniżej znajdują się aktualnie dostępne metadane, które mogą być używane ze zmiennymi konfiguracji.

Zmienna	Metadane wartości zmiennej
BuildDirectory	$(PackageLocation)
BuildNumber	$(BuildNumber)
BuildDefinition	$(BuildDefinition)
TFSCollection	$(TFSUrlWithCollection)
TeamProject	$(TeamProject)

Menedżer plików INI

Narzędzie modyfikuje zawartość pliku .ini i umożliwia utworzenie nowego pliku .ini, jeśli zostanie to określone.Narzędzie jest oparte na niestandardowej wersji pliku wykonywalnego zarządzania.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-Action		Tak	Wskazuje działanie do wykonania: ModifySection RemoveSection CreateKeyValue ModifyKeyValue RemoveKeyValue
-INIFile	INIFileName	Tak	Nazwa i ścieżka (jeśli wymagane) pliku .ini
-SectionName	SectionName	Nie	Nazwa sekcji do zmiany.Jeśli nie zostanie określona, używana będzie sekcja główna (wszystkie klucze, które znajdują się na początku pliku przed pierwszą sekcją, są uważane za klucze w katalogu głównym).
-NewSectionName		Nie	Nowa nazwa sekcji.Jeśli nie zostanie określona, używana będzie sekcja główna (wszystkie klucze, które znajdują się na początku pliku przed pierwszą sekcją, są uważane za klucze w katalogu głównym).Wymagane dla akcji ModifySection.
-KeyName		Nie	Nazwa klucza do zmiany.Wymagane dla CreateKeyValue, ModifyKeyValue i RemoveKeyValue.
-KeyValue		Nie	Wartość używana dla klucza.W przypadku korzystania z akcji ModifyKeyValue bez określenia tego parametru i przy jednoczesnym określeniu parametru NewKeyName, system użyje wartości rzeczywistej.Jeśli nie określono i NewKeyName nie jest określony, wartość będzie pusta.
-NewKeyName		Nie	Nowa nazwa do nadania dla klucza.Używana tylko w akcji ModifyKeyValue.
-CreateFileIfNotExists		Nie	Parametr wskazuje narzędziu, że plik musi zostać stworzony, jeśli jeszcze nie istnieje.

Proces systemu Windows

To narzędzie umożliwia zakończenie procesu systemu Windows.Zmienne konfiguracji tego narzędzia to:

Parametr	Zmienna	Obowiązkowa	Opis
-command	Nie dot.	Tak	Stała wartość ./WindowsProcess.ps1.
-ProcessName		Tak	Nazwa procesu systemu Windows do zatrzymania.
-UserName		Nie	Konto użytkownika, dla którego uruchomiony jest proces.Jeśli nie zostanie określone, proces będzie zatrzymany dla wszystkich użytkowników.
-IsKillProcessTree		Nie	Flaga wskazująca, jeśli muszą być zabijane drzewa procesów. Dopuszczalne wartości to: 1: Zatrzymaj drzewo procesów 0 lub pusty: Nie zatrzymuj drzewa procesów