Condividi tramite


PowerShellOnTargetMachines@1 - Attività PowerShell nei computer di destinazione v1

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