Strumenti di Release Management per distribuire un'app
In ogni azione di rilascio viene usato uno strumento di gestione del rilascio. Lo strumento Esecuzione riga di comando consente ad esempio di eseguire un file eseguibile specifico per un'azione. Se è necessario eseguire un'attività non supportata dagli strumenti forniti, è possibile creare uno strumento personalizzato e aggiungerlo a un'azione di rilascio personalizzata. Gli strumenti consentono inoltre di distribuire un componente dell'applicazione.
Di seguito viene riportato un elenco degli strumenti e dei parametri relativi forniti con Release Management.
Deployment Agent di database - Esegui script
Questo strumento consente di eseguire una query SQL su un database specifico. È basato sull'eseguibile sqlcmd standard distribuito con SQL Server. Per altre informazioni su questo eseguibile, vedere la documentazione di sqlcmd. Di seguito vengono elencate le variabili di configurazione per questo strumento.
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-S |
NomeServer |
Sì |
Nome del server del database SQL. |
-i |
ScriptName |
Sì |
Nome dello script da eseguire. |
-b |
N/D |
No |
Questo parametro è un'opzione. La sua presenza indica che si è verificato un errore e che il batch verrà interrotto. |
Deployment Agent di Reporting Services
Questo strumento consente di distribuire i rapporti di Reporting Services e gli oggetti correlati. È basato su un eseguibile di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-s |
serverUrl |
Sì |
URL completo del server di Reporting Services. |
-l |
itemLocation |
Sì se più elementi |
Percorso degli elementi. Se specificato, deve essere specificata la cartella (-f). |
-f |
folder |
Sì se più elementi |
Cartella degli elementi. Se specificato, deve essere specificato il percorso dell'elemento (-l). |
-t |
Sì |
Tipo di elemento da elaborare. Di seguito sono elencati i valori consentiti:
|
|
-sp |
No |
Elenco dei criteri di ricerca da usare per filtrare gli elementi. Ogni criterio di ricerca deve essere separato da una virgola o da un punto e virgola, ad esempio *.bmp;*.jpg. Se non specificato, il criterio di ricerca verrà definito nel modo seguente in base al tipo di elemento selezionato (-t):
|
|
-i |
Sì se singoli elementi |
File dell'elemento. Se specificato, deve essere specificato il nome dell'elemento (-n). Questo parametro viene usato quando deve essere distribuito un singolo elemento. In questo caso, i parametri item location (-l) e folder (-f) non devono essere presenti. |
|
-n |
Sì se singoli elementi |
Nome dell'elemento. Se specificato, deve essere specificato il file dell'elemento (-i). Questo parametro viene usato quando deve essere distribuito un singolo elemento. In questo caso, i parametri item location (-l) e folder (-f) non devono essere presenti. |
|
-log |
No |
Viene generato un file di log con il nome specificato nella directory fisica. |
|
-o |
N/D |
No |
Questo parametro è un'opzione. La sua presenza indica che la destinazione verrà sovrascritta se esiste già. |
-ds ds1,...,dsN |
Nome completo delimitato da virgole di tutte le origini dati da associare all'elemento. Questi valori rispettano la distinzione tra maiuscole e minuscole. Questa opzione si applica solo ai rapporti. Il formato dell'origine dati può essere [nome:] riferimento. Per "nome" si intende il nome dell'origine dati, come specificato nel rapporto in cui devono essere sostituiti i riferimenti. Per "riferimento" si intende il riferimento completo all'origine dati nel server di destinazione da usare per il rapporto. |
Deployment Agent di MSI
Questo strumento consente di distribuire un file MSI e disinstalla la precedente installazione del prodotto prima di installare quello nuovo. È basato su uno script di PowerShell di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-command |
N/D |
Sì |
Valore fisso ./msiexec.ps1. |
-MsiFileName |
Installer |
Sì |
Percorso completo (se richiesto) e nome del file MSI da installare. |
-MsiCustomArgs |
MsiCustomArgs |
No |
Argomenti personalizzati da usare per installare il file MSI. Questi argomenti vengono passati direttamente all'eseguibile msiexec. Se non sono necessari argomenti personalizzati, il parametro deve essere rimosso dagli argomenti. |
-PrevProductName |
No |
Consente all'utente di specificare il nome del prodotto precedente da disinstallare prima dell'installazione del file MSI. Per impostazione predefinita, verrà usato il nome del prodotto nel file MSI da installare. |
Deployment Agent XCopy
Questo strumento consente di copiare il percorso di un pacchetto in una destinazione specifica. È basato su uno script batch di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-source |
N/D |
Sì |
Valore fisso che indica che deve essere copiato l'intero percorso di origine |
-destination |
Percorso di installazione |
Sì |
Destinazione della copia. |
Esecuzione riga di comando
Questo strumento consente di eseguire un file eseguibile specifico. È basato su uno script di PowerShell di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-file |
N/D |
Sì |
Valore fisso ./RunCommandLine.ps1. |
-FilePath |
FilePath |
Sì |
Percorso completo (se richiesto) e nome file dell'eseguibile da eseguire. |
-Arguments |
Argomenti |
No |
Argomenti necessari per l'esecuzione dell'eseguibile. |
-UserDomain |
UserDomain |
No |
Dominio dell'utente da usare se l'eseguibile deve essere eseguito in un'identità specifica. Se non specificato, verrà usato l'utente locale (. \localuser). |
-UserName |
UserName |
No |
Nome dell'utente da usare se l'eseguibile deve essere eseguito in un'identità specifica. |
-UserPassword |
UserPassword |
No |
Password dell'utente da usare se l'eseguibile deve essere eseguito in un'identità specifica. |
Gestore Registro di sistema di Windows
Questo strumento consente di modificare le informazioni sul Registro di sistema di Windows. È basato su uno script di PowerShell di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-command |
N/D |
Sì |
Valore fisso ./ManageWindowsRegistry.ps1. |
-Action |
Azione |
Sì |
Azione da eseguire. Di seguito sono elencati i valori consentiti:
|
-OperatingSystemType |
No |
Indica se la chiave o il valore sono accessibili nel Registro di sistema a 32 bit oppure a 64 bit. Se non viene specificato alcun valore, viene usato il valore predefinito a 32 bit. |
|
-RegistryKey |
RegistryKey |
Sì |
Percorso e nome della chiave del Registro di sistema, ad esempio HKLM\Software\MyKey. |
-RegistryValue |
No* |
Valore del Registro di sistema a cui verranno applicate le modifiche, ad esempio MyValue. Necessario per CreateValue, ModifyValue e DeleteValue. |
|
-ValueType |
No |
Tipo del valore assegnato. Di seguito sono elencati i valori accettati:
|
|
-RegistryData |
No |
Dati da applicare al valore (se si usa CreateValue o ModifyValue) o al valore predefinito della chiave (se si usa CreateKey o ModifyKey). |
|
-RegistryKeyDestination |
No* |
Nome della chiave del Registro di sistema da usare quando si usare l'azione ModifyKey per rinominare una chiave del Registro di sistema. Ad esempio:
|
I/O comune Windows
Questo strumento consente di eseguire operazioni di I/O comuni in Windows. È basato su uno script di PowerShell di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-command |
N/D |
Sì |
Valore fisso ./ManageWindowsIO.ps1. |
-Action |
Azione |
Sì |
Indica l'azione da eseguire:
|
-FileFolderName |
FileFolderName |
Sì |
Percorso e nome del file o della cartella. |
-DestinationName |
No* |
Nome di destinazione (per l'azione di ridenominazione) o nome e percorso della cartella (per l'azione di spostamento). Necessario per le azioni di ridenominazione e spostamento. |
|
-ReadOnly |
No |
Consente all'utente di impostare o reimpostare l'attributo ReadOnly dei file o di una cartella.
|
|
-Archive |
No |
Consente all'utente di impostare o reimpostare l'attributo Archive dei file o di una cartella.
|
|
-System |
No |
Consente all'utente di impostare o reimpostare l'attributo di sistema dei file o di una cartella.
|
|
-Hidden |
No |
Consente all'utente di impostare o reimpostare l'attributo Hidden dei file o di una cartella.
|
|
-OwnerDomain |
No |
Rappresenta il dominio del nuovo proprietario del file o della cartella. |
|
-OwnerName |
No |
Rappresenta il nome del nuovo proprietario del file o della cartella. |
Gestore servizio Windows
Questo strumento consente di gestire i servizi Windows. È basato su uno script di PowerShell di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-command |
N/D |
Sì |
Valore fisso ./ManageWindowsServices.ps1. |
-Action |
Azione |
Sì |
Indica l'azione da eseguire:
|
-ServiceName |
ServiceName |
Sì |
Nome del servizio. |
-ServerName |
No |
Nome del server in cui verrà eseguita l'azione. Se non viene specificato, viene usato il server corrente. |
|
-BinPath |
No* |
Nome e percorso binario del servizio. Necessario per l'azione Create, facoltativo per l'azione Config e ignorato per tutte le altre. |
|
-DisplayName |
No |
Nome visualizzato che viene usato per questo servizio. Facoltativo per le azioni Create e Config e ignorato per tutte le altre. |
|
-Description |
No |
Descrizione che viene assegnata al servizio. Facoltativo per le azioni Create e Config e ignorato per tutte le altre. |
|
-UserName |
No |
Nome utente che viene usato per le credenziali per avviare il servizio (deve avere il formato DOMINIO\UTENTE). Se viene specificato, deve anche essere specificato il parametro -Password. Se non viene specificato, per impostazione predefinita viene usato l'account LocalSystem. Facoltativo per le azioni Create e Config e ignorato per tutte le altre. Per reimpostare le credenziali su LocalSystem, immettere LocalSystem come utente e "" come password. |
|
-Password |
No |
Password del nome utente specificato per avviare il servizio. Facoltativo per le azioni Create e Config e ignorato per tutte le altre. |
|
-StartMode |
No |
Modalità di avvio del servizio. Per impostazione predefinita, il servizio viene creato con Automatic. tra le seguenti:
Facoltativo per le azioni Create e Config e ignorato per tutte le altre. |
Deployment Agent di database DACPAC
Questo strumento consente di distribuire un pacchetto DACPAC e si basa su un'utilità della riga di comando di SQL Server. Sono disponibili numerosi possibili parametri per questo eseguibile, ma verrà fornito solo l'elenco usato per questo strumento. Per altre informazioni, vedere la pagina relativa all'utilità della riga di comando per un pacchetto SQL. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
/Action: |
Sì |
Valore fisso: Publish - specifica che il pacchetto verrà pubblicato. |
|
/SourceFile: |
NomeFile |
Sì |
Percorso completo (se richiesto) e nome del file DACPAC. |
/TargetServerName: |
NomeServer |
Sì |
Nome dell'istanza di SQL Server in cui pubblicare il pacchetto. |
/TargetDatabaseName: |
NomeDatabase |
Sì |
Nome del database di SQL Server in cui pubblicare il pacchetto. |
Deployment Agent di IIS
Questo strumento consente di modificare impostazioni e oggetti IIS. È basato su un eseguibile di Release Management personalizzato. Le variabili di configurazione di questo strumento variano a seconda del tipo di azioni da eseguire.
Per le azioni del pool di applicazioni:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-Action |
Sì |
Indica l'azione da eseguire:
|
|
-ap |
Sì |
Nome del pool di applicazioni. |
|
-apAllow32Bit |
No |
Flag che indica se il pool di applicazioni deve consentire le applicazioni a 32 bit. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. Di seguito sono elencati i valori consentiti:
|
|
-apIdentUserDomain |
No |
Dominio dell'utente da usare come identità del pool di applicazioni. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. Se non è definito e "IdentityUserName" è definito, l'utente viene considerato come locale (. \localuser). |
|
-apIdentUserName |
No |
Nome utente da usare come identità del pool di applicazioni. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. Se non è definito, "IdentityUserDomain" e "IdentityUserPassword" verranno ignorati e viene usato il valore predefinito di IIS, ovvero ApplicationPoolIdentity. |
|
-apIdentUserPassword |
No |
Password dell'utente da usare come identità del pool di applicazioni. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. |
|
-apNetVers |
No |
Versione di .NET Framework da usare per il pool di applicazioni. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. I valori consentiti sono: v1.0, v1.1, v2.0, v4.0 |
|
-apPipelineMode |
No |
Modalità pipeline gestita da usare nel pool di applicazioni. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. Di seguito sono elencati i valori consentiti:
|
|
-apProcessIdleTimeout |
No |
Numero di minuti durante i quali un processo può rimanere inattivo nel pool di applicazioni. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. |
|
-apRecycleKbMemory |
No |
Numero massimo di KB di memoria da usare prima che il pool di applicazioni venga riciclato. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. |
|
-apRecycleMinutes |
No |
Numero fisso di minuti dopo i quali il pool di applicazioni viene riciclato. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. |
|
- apRecycleSpecificTime |
No |
Ora fissa a cui il pool di applicazioni viene riciclato. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. Il formato richiesto è HH.MM, ad esempio 23.58 o 01.23. |
|
-apStartMode |
No |
Modalità di avvio da usare per il pool di applicazioni. Questo parametro è consentito solo per IIS 8.0 e 8.5. Di seguito sono elencati i valori consentiti:
|
|
-AutoStart |
No |
Flag che indica se il pool di applicazioni deve essere avviato automaticamente. Questo parametro è consentito solo per IIS 7.0, 7.5, 8.0 e 8.5. Di seguito sono elencati i valori consentiti:
|
|
-log |
No |
Per le azioni del sito Web:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-Action |
Sì |
Indica l'azione da eseguire:
|
|
-sn |
Sì |
Nome del sito Web. |
|
-port |
No* |
Numero di porta del sito Web. Obbligatorio per l'azione Create e facoltativo per Configure. |
|
-pd |
No* |
Percorso completo della posizione in cui è stata pubblicata l'applicazione. Obbligatorio per l'azione Create e facoltativo per Configure. .gif "Nota") Nota
Assicurarsi che il percorso non includa una barra finale.
|
|
-ap |
No |
Nome del pool di applicazioni. Se non viene definito durante la creazione del pool di applicazioni, viene usato il pool di applicazioni predefinito. Facoltativo per le azioni Create e Configure. |
|
-EnablePreload |
No |
Consentito in IIS 7.0, 7.5, 8.0 e 8.5. Flag che indica se il sito Web deve essere precaricato. Facoltativo per le azioni Create e Configure. I valori consentiti sono:
|
|
-AutoStart |
No |
Consentito in IIS 7.0, 7.5, 8.0 e 8.5. Flag che indica se il sito Web deve essere avviato automaticamente. Facoltativo per le azioni Create e Configure. I valori consentiti sono:
|
|
-log |
No |
Viene generato un file di log con il nome specificato nella directory fisica. |
Per le azioni dell'applicazione Web:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-Action |
Sì |
Indica l'azione da eseguire:
|
|
-ws |
Sì |
Nome dell'applicazione da creare. |
|
-pd |
No* |
Percorso completo della posizione in cui è stata pubblicata l'applicazione. Obbligatorio per l'azione Create e facoltativo per Configure. |
|
-sn |
No |
Nome del sito Web. Se non viene specificato, viene usato il sito Web predefinito per la creazione di una nuova applicazione. Facoltativo per le azioni Create e Configure. |
|
-ap |
No |
Nome del pool di applicazioni. Se non viene definito durante la creazione del pool di applicazioni, viene usato il pool di applicazioni predefinito. Facoltativo per le azioni Create e Configure. |
|
-EnablePreload |
No |
Consentito in IIS 7.0, 7.5, 8.0 e 8.5. Flag che indica se il sito Web deve essere precaricato. Facoltativo per le azioni Create e Configure. I valori consentiti sono:
|
|
-log |
No |
Nella directory fisica viene generato un file di log con il nome specificato. |
Per le azioni della directory virtuale:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-Action |
Sì |
Indica l'azione da eseguire:
|
|
-vd |
Sì |
Nome della directory virtuale. |
|
-pd |
No* |
Percorso completo della directory virtuale. Obbligatorio per l'azione Create e facoltativo per Configure. |
|
-sn |
No |
Nome del sito Web. Se non viene specificato, viene usato il sito Web predefinito per la creazione di una nuova applicazione. Facoltativo per le azioni Create e Configure. |
|
-ws |
No |
Nome dell'applicazione Web. Se non viene specificato, viene usata l'applicazione Web radice per la creazione di una nuova directory virtuale. Facoltativo per le azioni Create e Configure. |
|
-log |
No |
Nella directory fisica viene generato un file di log con il nome specificato. |
Gestore VM di Microsoft Azure
Questo strumento consente di gestire una macchina virtuale in Microsoft Azure. È basato su uno script di PowerShell di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-command |
N/D |
Sì |
Valore fisso ./ControlAzureVM.ps1. |
-Command |
Sì |
Indica l'azione da eseguire:
|
|
-ServiceName |
ServiceName |
Sì |
Nome del servizio Microsoft Azure in cui esiste la macchina virtuale. |
-Name |
Name |
Sì |
Nome della VM di Azure. |
Deployer XBAP
Questo strumento consente di distribuire un'applicazione XBAP. È basato su un eseguibile di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-pn |
ProjectName |
Sì |
Nome del progetto XBAP da distribuire. |
-d |
Percorso di installazione |
Sì |
Percorso di installazione dell'applicazione XBAP. |
-ml |
No |
Percorso completo dell'eseguibile dell'utilità mage. Se non viene definito, viene usato quello fornito come risorsa nello strumento. |
|
-pl |
No |
Percorso completo in cui si trova il progetto XBAP da distribuire. Se non viene specificato, viene usato il percorso del pacchetto in cui viene eseguito. |
|
-url |
No |
Se viene specificato, l'URL del file setup.exe viene sostituito con quello specificato. |
|
-cf |
No |
Se viene specificato, viene usato come nome della certificazione quando si aggiorna il manifesto. |
|
-pwd |
No |
Se specificato, viene usato come password della certificazione quando si aggiorna il manifesto. |
|
-log |
No |
Nella directory fisica viene generato un file di log con il nome specificato. |
Utilità della riga di comando Microsoft Test Manager
Questo strumento consente di creare e avviare test automatizzati eseguiti in Microsoft Test Manager. È basato su uno script di PowerShell di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-command |
N/D |
Sì |
Valore fisso ./TcmExec.ps1. |
-Title |
TestRunTitle |
Sì |
Nome che verrà usato per la creazione dell'esecuzione di test. |
-PlanId |
PlanId |
Sì |
Identificatore del piano di test con cui devono essere eseguiti i test (ID univoco come definito in Test Manager). |
-SuiteId |
SuiteId |
Sì |
Identificatore del gruppo da eseguire (ID univoco come definito in Test Manager). |
-ConfigId |
ConfigId |
Sì |
Identificatore della configurazione di test con cui devono essere eseguiti i test (ID univoco come definito in Test Manager). |
-Collection |
TFSCollection |
Sì |
URL di raccolta di Team Foundation Server per cui verranno eseguiti i test automatizzati. |
-TeamProject |
TeamProject |
Sì |
Nome del progetto Team in cui sono stati configurati i test automatizzati. |
-TestEnvironment |
TestEnvironment |
Sì |
Ambiente di test in cui devono essere eseguiti i test (l'ambiente di test è associato a un controller di test corrispondente). |
-BuildDirectory |
BuildDirectory |
No* |
Percorso dei test automatizzati. In MTM 2010 questo parametro è obbligatorio. In MTM 2012, 2013 questo parametro è ancora supportato, anche se è preferibile usare i parametri BuildDefinition e BuildNumber. |
-BuildDefinition |
No* |
Consente all'utente di specificare la definizione di compilazione in cui sono inclusi i test automatizzati. Questo parametro può essere usato solo con Microsoft Test Manager 2012. Se definito, è necessario specificare anche il parametro BuildNumber. Se non viene specificato, il campo "build" visibile nei dettagli di un'esecuzione di test non sarà interessato dall'esecuzione stessa. |
|
-BuildNumber |
No* |
Consente all'utente di specificare il numero di build la cui destinazione finale conterrà i test automatizzati. Questo parametro può essere usato solo in Microsoft Test Manager 2012. Se definito, è necessario specificare anche il parametro BuildDefinition. Se non viene specificato, il campo "build" visibile nei dettagli di un'esecuzione di test non sarà interessato dall'esecuzione stessa. |
|
-SettingsName |
No |
Consente all'utente di specificare le impostazioni da usare per l'esecuzione di test. Se non viene specificato, vengono usate le impostazioni di test predefinite. |
|
-TestRunWaitDelay |
No |
Consente all'utente di specificare il ritardo, in secondi, tra ogni chiamata al controller di test. È necessario per completare l'esecuzione di test prima che vengano elaborati i risultati dei test. Se non viene specificato, viene usato il valore predefinito, ovvero 10 secondi. |
|
-InconclusiveFailsTests |
N/D |
No |
Quando viene impostato questo flag, la presenza di test senza risultati genera un errore nella distribuzione. Per impostazione predefinita, un test senza risultati non genera alcun errore nella distribuzione. |
-RemoveIncludeParameter |
N/D |
No |
Quando viene impostato questo flag, il parametro /include non viene aggiunto al comando di creazione test. Ciò significa che i test con uno stato diverso da Active non vengono inclusi nell'esecuzione di test. |
Se i test automatizzati sono inclusi nello stesso processo di compilazione dell'applicazione da intende distribuire, è possibile usare metadati come valori della variabile che verranno sostituiti automaticamente al momento del rilascio. Di seguito sono riportati i valori di metadati attualmente disponibili che è possibile usare con le variabili di configurazione.
Variabile |
Metadati valore di variabile |
|---|---|
BuildDirectory |
$(PackageLocation) |
BuildNumber |
$(BuildNumber) |
BuildDefinition |
$(BuildDefinition) |
TFSCollection |
$(TFSUrlWithCollection) |
TeamProject |
$(TeamProject) |
Gestore file INI
Questo strumento consente di modificare il contenuto di un file INI e di crearne uno nuovo se specificato. È basato su un eseguibile di Release Management personalizzato. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-Action |
Sì |
Indica l'azione da eseguire:
|
|
-INIFile |
INIFileName |
Sì |
Percorso e nome del file INI (se richiesti) |
-SectionName |
SectionName |
No |
Nome della sezione da assegnare. Se non viene specificato, viene presa in considerazione la sezione radice (tutte le chiavi che si trovano all'inizio del file prima della prima sezione sono considerate come presenti nella radice). |
-NewSectionName |
No |
Nuovo nome della sezione. Se non viene specificato, viene presa in considerazione la sezione radice (tutte le chiavi che si trovano all'inizio del file prima della prima sezione sono considerate come presenti nella radice). Necessario per l'azione ModifySection. |
|
-KeyName |
No |
Nome della chiave da assegnare. Necessario per CreateKeyValue, ModifyKeyValue e RemoveKeyValue. |
|
-KeyValue |
No |
Valore da usare per la chiave. Quando si usare l'azione ModifyKeyValue e questo parametro non è specificato, mentre è specificato NewKeyName, viene usato il valore effettivo. Se non è specificato e non è specificato nemmeno NewKeyName, il valore viene lasciato vuoto. |
|
-NewKeyName |
No |
Nuovo nome da assegnare alla chiave. Usato solo nell'azione ModifyKeyValue. |
|
-CreateFileIfNotExists |
No |
Indica allo strumento che è necessario creare un file se non esiste. |
Processo Windows
Questo strumento consente di terminare un processo di Windows. Di seguito sono elencate le variabili di configurazione di questo strumento:
Parametro |
Variabile |
Obbligatorio |
Descrizione |
|---|---|---|---|
-command |
N/D |
Sì |
Valore fisso ./WindowsProcess.ps1. |
-ProcessName |
Sì |
Nome del processo Windows da terminare. |
|
-UserName |
No |
Account utente che esegue il processo. Se non viene specificato, il processo viene terminato per tutti gli utenti. |
|
-IsKillProcessTree |
No |
Flag che indica se l'albero processi deve essere terminato. I valori consentiti sono:
|