Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Usare questa attività per eseguire script di PowerShell nei computer remoti.
Sintassi
# PowerShell on Target Machines v1
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@1
inputs:
EnvironmentName: # string. Required. Machines.
#AdminUserName: # string. Admin Login.
#AdminPassword: # string. Password.
#Protocol: # 'Http' | 'Https'. Protocol.
#TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
# Deployment
ScriptPath: # string. Required. PowerShell Script.
#ScriptArguments: # string. Script Arguments.
#InitializationScriptPath: # string. Initialization Script.
#SessionVariables: # string. Session Variables.
# Advanced Options
#RunPowershellInParallel: true # boolean. Run PowerShell in Parallel. Default: true.
#ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
#MachineNames: # string. Filter Criteria.
Ingressi dati
computer EnvironmentName -
string. Obbligatorio.
Specifica un elenco delimitato da virgole di indirizzi IP o FQDN del computer, insieme alle porte. La porta predefinita si basa sul protocollo selezionato.
Ad esempio: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
È anche possibile specificare la variabile di output di altre attività, ad esempio $(variableName). Se si usa HTTPS, il nome o l'INDIRIZZO IP del computer deve corrispondere al cn nel certificato.
di accesso amministratore di AdminUserName -
string.
Specifica l'account di accesso amministratore per i computer di destinazione.
AdminPassword
-
password
string.
Specifica la password di amministratore per i computer di destinazione. Le variabili definite nelle definizioni di compilazione/versione come $(passwordVariable) vengono accettate. È possibile contrassegnare il tipo di variabile come secret per proteggerlo.
protocollo Protocol -
string. Valori consentiti: Http, Https.
Specifica il protocollo da usare per la connessione WinRM con i computer. Il valore predefinito è HTTPS.
TestCertificate
-
certificato di test
boolean. Opzionale. Usare quando Protocol = Https. Valore predefinito: true
Ignora la convalida dell'autenticità del certificato del computer da parte di un'autorità di certificazione attendibile. Il parametro è obbligatorio per il protocollo HTTPS WinRM.
ScriptPath
-
script di PowerShell
string. Obbligatorio.
Specifica il percorso dello script di PowerShell nei computer di destinazione o in un percorso UNC, ad esempio C:\BudgetIT\Web\Deploy\Website.ps1.
argomenti script ScriptArguments -
string.
Specifica gli argomenti per lo script di PowerShell. Può essere ordinale o parametri denominati, ad esempio -testParam test.
InitializationScriptPath
-
script di inizializzazione
string.
Specifica il percorso dello script di dati per DSC nei computer di destinazione o in un percorso UNC, ad esempio C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.
SessionVariables
-
variabili di sessione
string.
Specifica le variabili di sessione comuni per entrambi gli script. Ad esempio, $variable = value o $var1 = "value, 123".
RunPowershellInParallel
-
eseguire PowerShell in parallelo
boolean. Valore predefinito: true
Se impostato su true, esegue gli script di PowerShell in parallelo nei computer di destinazione.
ResourceFilteringMethod
-
Selezionare computer per
string. Valori consentiti: machineNames (nomi computer), tags. Valore predefinito: machineNames
Opzionale. Specifica un subset di computer specificando i nomi o i tag del computer.
MachineNames
-
criteri di filtro
string.
Questo input è valido solo per i gruppi di computer o le variabili di output. Non è ancora supportato per un elenco semplice di computer.
Specifica un elenco di computer, ad esempio dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 o tag, ad esempio Role:DB; OS:Win8.1. Se vengono specificati più tag, l'attività verrà eseguita in tutti i computer con i tag specificati. Il valore predefinito esegue l'attività in tutti i computer.
Opzioni di controllo attività
Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.
Variabili di output
Nessuno.
Requisiti
| Requisito | Descrizione |
|---|---|
| Tipi di pipeline | YAML, build classica, versione classica |
| Viene eseguito in | Agente, DeploymentGroup |
| richieste | Nessuno |
| funzionalità di |
Questa attività non soddisfa alcuna richiesta di attività successive nel processo. |
| restrizioni dei comandi | Qualunque |
| variabili impostabili | Qualunque |
| Versione dell'agente | 1.104.0 o versione successiva |
| Categoria attività | Distribuire |