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

Articolo
07/02/2024

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.

Input

EnvironmentName - Macchine
string. Obbligatorio.

Specifica un elenco delimitato da virgole di indirizzi IP del computer o FQDN, insieme alle porte. La porta predefinita è basata sul protocollo selezionato.
ad esempio dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
È anche possibile fornire la variabile di output di altre attività, ad esempio $(variableName). Se si usa HTTPS, il nome o l'INDIRIZZO IP del computer devono corrispondere al CN nel certificato.

AdminUserName - Amministrazione account di accesso
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/rilascio sono $(passwordVariable) accettate. È possibile contrassegnare il tipo di variabile per secret proteggerlo.

Protocol - Protocollo
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. facoltativo. 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 è necessario per il protocollo HTTPS WinRM.

ScriptPath - PowerShell Script
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.

ScriptArguments - Argomenti script
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.

facoltativo. Specifica un subset di computer fornendo nomi di computer o tag.

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 flat di computer.

Specifica un elenco di computer, ad esempio dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 o tag, come 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 delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input 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
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.104.0 o versione successiva
Categoria attività	Distribuire

Condividi tramite