Sdílet prostřednictvím


Nástroje Release Management pro nasazení aplikace

Každá z akcí vydání verze používá určitý nástroj pro správu vydávání verzí.Například Command Line Runner je nástroj, který spustí spustitelný soubor určený pro danou akci.Pokud potřebujete provést úlohu, kterou poskytnuté nástroje nepodporují, můžete vytvořit vlastní nástroj a přidat ho k vlastní akci vydání verze.Nástroje lze využít také k nasazení součástí aplikace.

Následující seznam shrnuje nástroje, které jsou k dispozici v softwaru Release Management, a odpovídající parametry:

Database Deployment Agent – Spustit skript

Tento nástroj provede dotaz SQL v zadané databázi.Je založen na standardním spustitelném souboru sqlcmd, který se distribuuje se serverem SQL.Další informace o spustitelném souboru sqlcmd naleznete v jeho dokumentaci.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-S

ServerName

Ano

Název serveru s databází SQL.

-i

ScriptName

Ano

Název souboru, který chcete spustit.

-b

Není k dispozici

Ne

Tento parametr představuje přepínač.Pokud je zadán, znamená to, že pokud dojde k chybě, dávka se přeruší.

Reporting Services Deployment Agent

Tento nástroj umožňuje nasazení sestav služby pro vykazování a souvisejících objektů.Je založen na vlastním spustitelném souboru pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-s

serverUrl

Ano

Úplná adresa URL serveru služby pro vykazování

-l

itemLocation

Ano, pokud se jedná o více položek

Umístění položek.Je-li tento parametr zadán, musí být zadána složka (-f).

-f

folder

Ano, pokud se jedná o více položek

Složka s položkami.Je-li tento parametr zadán, je třeba zadat umístění položky (-l).

-t

Ano

Typ položky, která má být zpracována.Povolené hodnoty jsou následující:

  • Sestava

  • Obrázek

-sp

Ne

Seznam vyhledávacích vzorů pro filtrování položek.Jednotlivé vyhledávací vzory musí být odděleny čárkou nebo středníkem (například *.bmp; *.jpg).Pokud tento parametr není zadán, vyhledávací vzory budou podle typu vybrané položky (-t) následující:

  • Sestava: *.rdl

  • Obrázek: *.bmp, *.gif, *.jpg, *.jpeg, *.png

-i

Ano, pokud se jedná o jednu položku

Soubor položky.Je-li tento parametr zadán, je třeba zadat název položky (-n).Tento parametr se používá, pokud je třeba nasadit jednu položku.V takovém případě nesmí být zadány parametry umístění položky (-l) a složka (-f).

-n

Ano, pokud se jedná o jednu položku

Název položky.Je-li tento parametr zadán, je třeba zadat soubor položky (-i).Tento parametr se používá, pokud je třeba nasadit jednu položku.V takovém případě nesmí být zadány parametry umístění položky (-l) a složka (-f).

-log

Ne

Ve fyzickém adresáři se vygeneruje soubor protokolu s tímto názvem.

-o

Není k dispozici

Ne

Tento parametr představuje přepínač.Pokud je tento parametr zadán, znamená to, že již existující cíl se přepíše.

-ds ds1,..., dsN

Plně kvalifikované názvy všech zdrojů dat, které chcete přiřadit k položce, oddělené čárkami.Rozlišují se malá a velká písmena.Tato možnost se týká pouze sestav.Zdroj dat může být ve formátu [název:] odkaz.Název je název zdroje dat, který je uveden v sestavě, kde se mají nahradit odkazy.Odkaz je plně kvalifikovaný odkaz na zdroj dat na cílovém serveru, který chcete pro sestavu použít.

MSI Deployment Agent

Tento nástroj umožňuje nasazení MSI.Před instalací odinstaluje předchozí instalaci produktu.Je založen na vlastním skriptu prostředí PowerShell pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-command

Není k dispozici

Ano

Pevná hodnota ./msiexec.ps1.

-MsiFileName

Instalační služba

Ano

Úplná cesta (je-li vyžadována) a název souboru MSI, který se má nainstalovat.

-MsiCustomArgs

MsiCustomArgs

Ne

Vlastní argumenty, které se mají použít při instalaci souboru MSI.Tyto argumenty budou předány přímo spustitelnému souboru msiexec.Pokud nejsou nutné žádné vlastní argumenty, je třeba parametr z argumentů odebrat.

-PrevProductName

Ne

Umožňuje uživateli zadat název předchozího produktu, který se má odinstalovat před instalací souboru MSI.Ve výchozím nastavení použije systém název produktu v souboru MSI, který se instaluje.

XCopy Deployment Agent

Tento nástroj zkopíruje umístění balíčku do zadaného cíle.Je založen na vlastním skriptu dávky pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-source

Není k dispozici

Ano

Pevná hodnota označující, že je třeba zkopírovat úplné zdrojové umístění.

-destination

Cesta instalace

Ano

Cíl kopírování

Command Line Runner

Tento nástroj spustí požadovaný spustitelný soubor.Je založen na vlastním skriptu prostředí PowerShell pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-file

Není k dispozici

Ano

Pevnou hodnotu. / RunCommandLine.ps1.

-FilePath

FilePath

Ano

Úplná cesta (je-li vyžadována) a název spustitelného souboru, který se má spustit

-Arguments

Arguments

Ne

Argumenty potřebné ke spuštění spustitelného souboru

-UserDomain

UserDomain

Ne

Doména uživatele, která se má použít, pokud je spustitelný soubor třeba spustit s určitou identitou.Pokud není zadáno, bude použit místní uživatel (.\localuser).

-UserName

UserName

Ne

Jméno uživatele, které se má použít, pokud je spustitelný soubor třeba spustit s určitou identitou

-UserPassword

UserPassword

Ne

Heslo uživatele, které se má použít, pokud je spustitelný soubor třeba spustit s určitou identitou

Windows Registry Manager

Tento nástroj provádí úpravy informací v registru systému Windows.Je založen na vlastním skriptu prostředí PowerShell pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-command

Není k dispozici

Ano

Pevná hodnota ./ManageWindowsRegistry.ps1.

-Action

Akce

Ano

Akce, která má být provedenaPovolené hodnoty jsou následující:

  • CreateKey: Vytvoření nového klíče registru

  • ModifyKey: Změna klíče registru nebo souvisejících dat

  • DeleteKey: Odstranění klíče registru se všemi jeho hodnotami a podklíči

  • CreateValue: Vytvoření nové hodnoty registru, která bude umístěna pod klíčem

  • ModifyValue: Změna hodnoty registru, která bude umístěna pod klíčem

  • DeleteValue: Odstranění hodnoty registru, která je umístěna pod klíčem

-OperatingSystemType

Ne

Označuje, zda je ke klíči nebo hodnotě přístup v 32bitovém, nebo 64bitovém registru.Pokud tento parametr není zadán, je výchozí 32bitový registr.

-RegistryKey

RegistryKey

Ano

Cesta a název klíče registru (například HKLM\Software\MyKey)

-RegistryValue

Ne*

Hodnota registru, u které se použijí změny (například MyValue).Povinné u akcí CreateValue, ModifyValue a DeleteValue.

-ValueType

Ne

Typ hodnoty, která má být ovlivněna.Povolené hodnoty jsou následující:

  • REG_SZ: Řetězec (výchozí hodnota, pokud není parametr zadán)

  • REG_QWORD_LITTLE_ENDIAN: 64bitová čísla ve formátu little endian

  • REG_QWORD: 64bitová čísla

  • REG_NONE: Žádná hodnota

  • REG_MULTI_SZ: Víceřádkové řetězce (oddělené znaky \0)

  • REG_LINK: Symbolický odkaz

  • REG_EXPAND_SZ: Řetězec s nerozbalenými odkazy na proměnné prostředí

  • REG_DWORD_BIG_ENDIAN: 32bitová čísla ve formátu big endian

  • REG_DWORD_LITTLE_ENDIAN: 32bitová čísla ve formátu little endian

  • REG_DWORD: 32bitová čísla

  • REG_BINARY: Binární data v libovolné formě

-RegistryData

Ne

Data, která se použijí pro hodnotu (pokud se používá akce CreateValue nebo ModifyValue) nebo pro výchozí hodnotu klíče (pokud se používá akce CreateKey nebo ModifyKey)

-RegistryKeyDestination

Ne*

Název klíče registru, který se má použít u akce ModifyKey pro přejmenování klíče registruPříklad:

  • RegistryKey = HKLM\Software\MyKey

  • RegistryKeyDestination = HKLM\Software\MyModifiedKey Požadováno u akce ModifyKey.

Windows Common IO

Tento nástroj provádí běžné vstupně-výstupní operace v systému Windows.Je založen na vlastním skriptu prostředí PowerShell pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-command

Není k dispozici

Ano

Pevná hodnota ./ManageWindowsIO.ps1.

-Action

Akce

Ano

Označuje akci, která se má provést:

  • Create: Vytvoření nové složky

  • Delete: Odstranění souboru nebo složky

  • Rename: Přejmenování souboru nebo složky

  • Move: Přesunutí souboru nebo složky

  • Attrib: Změna atributů (včetně vlastnictví) souboru nebo složky

-FileFolderName

FileFolderName

Ano

Název souboru nebo složky a cesta k nim

-DestinationName

Ne*

Název cílového (pro akci Přejmenovat) nebo cestu ke složce a název (přesunout akce). Je požadována pro přesunutí a přejmenování akce.

-ReadOnly

Ne

Umožní uživateli nastavit nebo obnovit atribut pouze pro čtení u souboru nebo složky.

  • +: Nastavit příznak

  • -: Zrušit příznak

  • Všechny ostatní hodnoty: Ponechat stávající příznak

-Archive

Ne

Umožní uživateli nastavit nebo obnovit atribut pro archivaci souboru nebo složky.

  • +: Nastavit příznak

  • -: Zrušit příznak

  • Všechny ostatní hodnoty: Ponechat stávající příznak

-System

Ne

Umožní uživateli nastavit nebo obnovit systémový atribut souboru nebo složky.

  • +: Nastavit příznak

  • -: Zrušit příznak

  • Všechny ostatní hodnoty: Ponechat stávající příznak

-Hidden

Ne

Umožní uživateli nastavit nebo obnovit skrytý atribut souboru nebo složky.

  • +: Nastavit příznak

  • -: Zrušit příznak

  • Všechny ostatní hodnoty: Ponechat stávající příznak

-OwnerDomain

Ne

Představuje doménu nového vlastníka souboru nebo složky.

-OwnerName

Ne

Představuje jméno nového vlastníka souboru nebo složky.

Windows Service Manager

Tento nástroj slouží ke správě služeb systému Windows.Je založen na vlastním skriptu prostředí PowerShell pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-command

Není k dispozici

Ano

Pevná hodnota ./ManageWindowsServices.ps1.

-Action

Akce

Ano

Označuje akci, která se má provést:

  • Create: Vytvoření nové služby

  • Config: Konfigurace stávající služby

  • Delete: Odstranění stávající služby

  • Start: Spuštění služby

  • Stop: Zastavení služby

  • Restart: Zastavení a opětovné spuštění služby

-ServiceName

ServiceName

Ano

Název služby

-ServerName

Ne

Název serveru, kde bude tato akce provedena.Pokud není zadán, použije se aktuální server.

-BinPath

Ne*

Binární cesta a název služby.Parametr je povinný pro akci Create, volitelný pro akci Config, u všech ostatních akcí se ignoruje.

-DisplayName

Ne

Zobrazovaný název, který se použije pro tuto službu.Parametr je volitelný pro akce Create a Config, u všech ostatních se ignoruje.

-Description

Ne

Popis, který bude přiřazen služběParametr je volitelný pro akce Create a Config, u všech ostatních se ignoruje.

-UserName

Ne

Jméno uživatele, které se použije pro pověření ke spuštění služby (musí být ve tvaru DOMÉNA\UŽIVATEL).Je-li tento parametr zadán, musí být zadán také parametr –Password.Není-li parametr zadán, použije se ve výchozím nastavení účet LocalSystem.Parametr je volitelný pro akce Create a Config, u všech ostatních se ignoruje.

Chcete-li obnovit pověření k systému LocalSystem, zadejte jako uživatele hodnotu LocalSystem a jako heslo řetězec "".

-Password

Ne

Heslo pro uživatelské jméno, které má službu spustit.Parametr je volitelný pro akce Create a Config, u všech ostatních se ignoruje.

-StartMode

Ne

Režim spouštění služby.Ve výchozím nastavení bude služba vytvořena pomocí automatického režimu.Dostupné volby jsou:

  • Ručně: Služba se spouští pouze ručně.

  • Automaticky: Služba se spustí automaticky při příštím restartování počítače.

  • Deaktivováno: Služba je deaktivována.

Parametr je volitelný pro akce Create a Config, u všech ostatních se ignoruje.

DACPAC Database Deployment Agent

Tento nástroj umožňuje nasazení balíčku DACPAC.Je založen na nástroji příkazového řádku systému SQL Server.Pro tento spustitelný soubor je k dispozici mnoho možných parametrů. Následující seznam obsahuje parametry, které se používají pro tento nástroj.Další informace naleznete v utilitě příkazového řádku pro balíček SQL.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

/Action:

Ano

Pevná hodnota: Publish – určuje, že balíček bude publikován.

/SourceFile:

FileName

Ano

Úplná cesta (je-li vyžadována) a název souboru DACPAC

/TargetServerName:

ServerName

Ano

Název serveru SQL Server, kam se má balíček publikovat

/TargetDatabaseName:

DatabaseName

Ano

Název databáze serveru SQL Server, kam se má balíček publikovat

IIS Deployment Agent

Tento nástroj provádí úpravy objektů a nastavení služby IIS.Je založen na vlastním spustitelném souboru pro správu vydávání verzí.Konfigurační proměnné tohoto nástroje se liší podle typu prováděných akcí.

Pro akce fondu aplikací:

Parametr

Proměnná

Povinné

Popis

-Action

Ano

Označuje akci, která se má provést:

  • CreateApplicationPool

  • ConfigureApplicationPool

  • DropApplicationPool

  • StartApplicationPool

  • StopApplicationPool

  • RecycleApplicationPoo

-ap

Ano

Název fondu aplikací

-apAllow32Bit

Ne

Příznak, který označuje, zda fond aplikací musí povolit 32bitové aplikace.Tento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.Povolené hodnoty jsou následující:

  • 1 nebo True: 32bitové aplikace jsou povoleny.

  • 0 nebo False: 32bitové aplikace nejsou povoleny.

-apIdentUserDomain

Ne

Doména uživatele, který se má použít jako identita fondu aplikací.Tento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.Pokud není definována a "IdentityUserName" je definována, uživatel bude považován za místního uživatele (.\localuser).

-apIdentUserName

Ne

Uživatelské jméno, které se má použít jako identita fondu aplikací.Tento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.Pokud tento parametr není definován, parametry "IdentityUserDomain" a "IdentityUserPassword" budou ignorovány a použije se výchozí hodnota služby IIS (ApplicationPoolIdentity).

-apIdentUserPassword

Ne

Heslo uživatele, který se má použít jako identita fondu aplikací.Tento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.

-apNetVers

Ne

Verze rozhraní .NET Framework, které se má použít pro fond aplikací.Tento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.Povolené hodnoty jsou: v1.0, v1.1, v2.0 nebo v4.0.

-apPipelineMode

Ne

Spravovaný režim procesu vydávání verzí, který se má použít ve fondu aplikacíTento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.Povolené hodnoty jsou následující:

  • Klasický

  • Integrovaný

-apProcessIdleTimeout

Ne

Počet minut, po který může být proces ve fondu aplikací nečinnýTento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.

-apRecycleKbMemory

Ne

Maximální počet kilobajtů paměti, který lze použít, než se fond aplikací recyklujeTento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.

-apRecycleMinutes

Ne

Pevný počet minut, po kterém se fond aplikací recyklujeTento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.

-apRecycleSpecificTime

Ne

Pevně stanovený čas, kdy se fond aplikací recyklujeTento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.Požadovaný formát je HH:MM (například 23:58 nebo 01:23).

-apStartMode

Ne

Režim spuštění, který se má použít ve fondu aplikací.Tento parametr je povolen pouze ve službě IIS 8.0 a 8.5.Povolené hodnoty jsou následující:

  • OnDemand

  • AlwaysRunning

-AutoStart

Ne

Příznak, který označuje, zda se fond aplikací musí spouštět automaticky.Tento parametr je povolen pouze ve službě IIS 7.0, 7.5, 8.0 a 8.5.Povolené hodnoty jsou následující:

  • 1 nebo True: Fond aplikací se spustí automaticky při spuštění Windows.

  • 0 nebo True: Při spuštění Windows se fond aplikací automaticky nespustí.

-log

Ne

Pro akce webové stránky:

Parametr

Proměnná

Povinné

Popis

-Action

Ano

Označuje akci, která se má provést:

  • CreateWebSite

  • ConfigureWebSite

  • DropWebSite

  • StartWebSite

  • StopWebSite

  • RestartWebSite

-sn

Ano

Název webové stránky

-port

Ne*

Číslo portu webové stránky.Povinné pro akci vytvoření, volitelné pro akci konfigurace.

-pd

Ne*

Úplná cesta směrování do umístění, kde byla aplikace publikována.Povinné pro akci vytvoření, volitelné pro akci konfigurace.

PoznámkaPoznámka
Ujistěte se, že neexistuje žádná koncové lomítko v cestě.

-ap

Ne

Název fondu aplikací.Pokud není definován při vytváření fondu aplikací, použije se výchozí fond aplikací.Volitelné pro akce vytvoření a konfigurace.

-EnablePreload

Ne

Povoleno ve službě IIS 7.0, 7.5, 8.0 a 8.5.Příznak, který označuje, zda musí být webová stránka předem načtena.Volitelné pro akce vytvoření a konfigurace.Povolené hodnoty jsou následující:

  • 1 nebo True: Předběžné načtení povoleno

  • 0 nebo False: Předběžné načtení zakázáno

-AutoStart

Ne

Povoleno ve službě IIS 7.0, 7.5, 8.0 a 8.5.Příznak, který označuje, zda se webová stránka musí spouštět automaticky.Volitelné pro akce vytvoření a konfigurace.Povolené hodnoty jsou následující:

  • 1 nebo True: Spouštět automaticky

  • 0 nebo False: Nespouštět automaticky

-log

Ne

Ve fyzickém adresáři se vygeneruje soubor protokolu s tímto názvem.

Pro akce webových aplikací:

Parametr

Proměnná

Povinné

Popis

-Action

Ano

Označuje akci, která se má provést:

  • CreateWebApplication

  • ConfigureWebApplication

  • DropWebApplication

-ws

Ano

Název aplikace, která se má vytvořit

-pd

Ne*

Úplná cesta směrování do umístění, kde byla aplikace publikována.Povinné pro akci vytvoření, volitelné pro akci konfigurace.

-sn

Ne

Název webové stránky.Pokud název není zadán, použije systém při vytváření nové aplikace výchozí webovou stránku.Volitelné pro akce vytvoření a konfigurace.

-ap

Ne

Název fondu aplikací.Pokud není definován při vytváření fondu aplikací, použije se výchozí fond aplikací.Volitelné pro akce vytvoření a konfigurace.

-EnablePreload

Ne

Povoleno ve službě IIS 7.0, 7.5, 8.0 a 8.5.Příznak, který označuje, zda musí být webová stránka předem načtena.Volitelné pro akce vytvoření a konfigurace.Povolené hodnoty jsou následující:

  • 1 nebo True: Předběžné načtení povoleno

  • 0 nebo False: Předběžné načtení zakázáno

-log

Ne

Ve fyzickém adresáři se vygeneruje soubor protokolu s tímto názvem.

Pro akce virtuálního adresáře:

Parametr

Proměnná

Povinné

Popis

-Action

Ano

Označuje akci, která se má provést:

  • CreateVirtualDirectory

  • ConfigureVirtualDirectory

  • DropVirtualDirectory

-vd

Ano

Název virtuálního adresáře

-pd

Ne*

Úplná cesta k virtuálnímu adresáři.Povinné pro akci vytvoření, volitelné pro akci konfigurace.

-sn

Ne

Název webové stránky.Pokud název není zadán, použije systém při vytváření nové aplikace výchozí webovou stránku.Volitelné pro akce vytvoření a konfigurace.

-ws

Ne

Název webové aplikace.Pokud název není zadán, použije systém při vytváření virtuálního adresáře kořenovou webovou aplikaci.Volitelné pro akce vytvoření a konfigurace.

-log

Ne

Ve fyzickém adresáři se vygeneruje soubor protokolu s tímto názvem.

Virtuální počítač správce Microsoft Azure

Tento nástroj spravuje virtuálního počítače v systému Microsoft Azure.Je založen na vlastním skriptu prostředí PowerShell pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-command

Není k dispozici

Ano

Pevná hodnota ./ControlAzureVM.ps1.

-Command

Ano

Označuje akci, která se má provést:

  • Start: Spuštění virtuálního počítače

  • Stop: Zastavení virtuálního počítače

-ServiceName

ServiceName

Ano

Název služby Microsoft Azure, ve kterém virtuální počítač existuje.

-Name

Name

Ano

Název Microsoft Azure VM.

XBAP Deployer

Tento nástroj umožňuje nasazení aplikace XBAP.Je založen na vlastním spustitelném souboru pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-pn

ProjectName

Ano

Název projektu XBAP, který se má nasadit

-d

Cesta instalace

Ano

Instalační cesta aplikace XBAP

-ml

Ne

Úplná cesta ke spustitelnému souboru nástroje bitové kopie.Pokud není cesta definována, použije nástroj soubor, který je k dispozici jako prostředek v nástroji.

-pl

Ne

Úplná cesta k umístění projektu XBAP, který se má nasadit.Pokud cesta není zadána, použije nástroj umístění balíčku, kde se spouští.

-url

Ne

Pokud je tento parametr zadán, systém nahradí adresu URL v souboru setup.exe zadanou hodnotou.

-cf

Ne

Je-li tento parametr zadán, použije se jako název certifikace při aktualizaci manifestu.

-pwd

Ne

Je-li tento parametr zadán, použije se jako heslo certifikace při aktualizaci manifestu.

-log

Ne

Ve fyzickém adresáři se vygeneruje soubor protokolu s tímto názvem.

Microsoft Test Manager (MTM) Command-Line Utility

Tento nástroj umožňuje vytvářet a spouštět automatizované testy běžící v prostředí nástroje MTM (Microsoft Test Manager).Je založen na vlastním skriptu prostředí PowerShell pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-command

Není k dispozici

Ano

Pevná hodnota ./TcmExec.ps1.

-Title

TestRunTitle

Ano

Název, který se použije při vytváření běhu testu

-PlanId

PlanId

Ano

Identifikátor testovacího plánu, s kterým je třeba testy spustit (jedinečné ID definované v nástroji Test Manager)

-SuiteId

SuiteId

Ano

Identifikátor sady, kterou chcete spustit (jedinečné ID definované v nástroji Test Manager)

-ConfigId

ConfigId

Ano

Identifikátor testovací konfigurace, s kterým je třeba testy spustit (jedinečné ID definované v nástroji Test Manager)

-Collection

TFSCollection

Ano

Adresa URL kolekce systému Team Foundation Server, pro kterou se automatické testy provedou

-TeamProject

TeamProject

Ano

Název týmového projektu, ve kterém byly automatické testy nakonfigurovány

-TestEnvironment

TestEnvironment

Ano

Testovací prostředí, ve kterém se mají testy provést (testovací prostředí je přiřazeno odpovídajícímu řadiči testů)

-BuildDirectory

BuildDirectory

Ne*

Umístění automatizovaných testů.V nástroji MTM 2010 je tento parametr povinný.V nástroji MTM 2012 a 2013 je tento parametr stále podporován, uživatelům se však doporučuje používat spíše parametry BuildDefinition a BuildNumber.

-BuildDefinition

Ne*

Umožňuje uživateli zadat definici sestavení, ve kterém jsou zahrnuty automatické testy.Tento parametr lze použít pouze v nástroji MTM 2012.Pokud je definován, musí být zadán také parametr BuildNumber.Pokud není zadán, pole "sestavení" v podrobnostech testovacího běhu nebude spuštěním testu ovlivněno.

-BuildNumber

Ne*

Umožňuje uživateli určit číslo sestavení, jehož odkládací adresář bude obsahovat automatické testy.Tento parametr lze použít pouze v nástroji MTM 2012.Pokud je definován, musí být zadán také parametr BuildDefinition.Pokud není zadán, pole "sestavení" v podrobnostech testovacího běhu nebude spuštěním testu ovlivněno.

-SettingsName

Ne

Umožňuje uživateli zadat nastavení, které se má použít v testovacím běhu.Pokud tento parametr není zadán, použijí se výchozí nastavení testu.

-TestRunWaitDelay

Ne

Umožňuje uživateli určit prodlevu (v sekundách) mezi jednotlivými voláními řadiče testů.Tento parametr je povinný a zajišťuje, aby se testovací běh před zpracováním výsledků testů dokončil.Pokud parametr není zadán, použije se výchozí hodnota 10 sekund.

-InconclusiveFailsTests

Není k dispozici

Ne

Pokud je tento příznak nastaven, nasazení se nezdaří, existují-li neprůkazné testy.Ve výchozím nastavení neznamená neprůkazný test selhání nasazení.

-RemoveIncludeParameter

Není k dispozici

Ne

Pokud je tento příznak nastaven, k příkazu pro vytvoření testu se nepřipojí parametr /include.To znamená, že do testovacího běhu nebudou zahrnuty testy v jiném stavu než Aktivní.

Pokud jsou automatizované testy zahrnuty do stejného procesu sestavení jako nasazovaná aplikace, je možné použít jako hodnotu proměnné metadata, která budou v okamžiku vydání verze automaticky nahrazena.Následující seznam uvádí aktuálně dostupná metadata, která lze použít spolu s proměnnými konfigurace.

Proměnná

Metadata hodnot proměnných

BuildDirectory

$(PackageLocation)

BuildNumber

$(BuildNumber)

BuildDefinition

$(BuildDefinition)

TFSCollection

$(TFSUrlWithCollection)

TeamProject

$(TeamProject)

INI File Manager

Tento nástroj upraví obsah souboru INI a podle požadavků případně může vytvořit nový soubor INI.Je založen na vlastním spustitelném souboru pro správu vydávání verzí.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-Action

Ano

Označuje akci, která se má provést:

  • ModifySection

  • RemoveSection

  • CreateKeyValue

  • ModifyKeyValue

  • RemoveKeyValue

-INIFile

INIFileName

Ano

Název a cesta k souboru INI (jsou-li požadovány)

-SectionName

SectionName

Ne

Název oddílu, který má být ovlivněn.Pokud název není zadán, použije se kořenový oddíl (všechny klíče umístěné na začátku souboru před prvním oddílem jsou pokládány za klíče umístěné v kořenovém oddílu).

-NewSectionName

Ne

Nový název oddílu.Pokud název není zadán, použije se kořenový oddíl (všechny klíče umístěné na začátku souboru před prvním oddílem jsou pokládány za klíče umístěné v kořenovém oddílu).Povinný parametr u akce ModifySection.

-KeyName

Ne

Název klíče, který má být ovlivněn.Povinný parametr u akcí CreateKeyValue, ModifyKeyValue a RemoveKeyValue.

-KeyValue

Ne

Hodnota, která se má použít pro klíč.Pokud tento parametr u akce ModifyKeyValue není zadán a je zadán parametr NewKeyName, použije systém skutečnou hodnotu.Pokud tento parametr není zadán a není zadán ani parametr NewKeyName, hodnota zůstane prázdná.

-NewKeyName

Ne

Nový název, který chcete klíči přiřadit.Používá se pouze u akce ModifyKeyValue.

-CreateFileIfNotExists

Ne

Určuje, že pokud soubor neexistuje, má jej nástroj vytvořit.

Windows Process

Tento nástroj umožňuje ukončit proces systému Windows.Tento nástroj používá následující proměnné konfigurace:

Parametr

Proměnná

Povinné

Popis

-command

Není k dispozici

Ano

Pevná hodnota ./WindowsProcess.ps1.

-ProcessName

Ano

Název procesu systému Windows, který se má ukončit.

-UserName

Ne

Uživatelský účet, ve kterém je proces spuštěn.Pokud není zadán, ukončí se proces u všech uživatelů.

-IsKillProcessTree

Ne

Příznak, který určuje, pokud musí ukončit strom procesu. Povolené hodnoty jsou:

  • 1. Ukončit strom procesu

  • 0 nebo prázdné: Neukončovat strom procesu