PowerShellOnTargetMachines@2 - Attività PowerShell nei computer di destinazione v2

Articolo
06/11/2024

Usare questa attività per eseguire script di PowerShell nei computer remoti.

Sintassi

# PowerShell on Target Machines v2
# Execute PowerShell scripts on remote machine(s).
- task: PowerShellOnTargetMachines@2
  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 o FQDN del computer, 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 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.

AdminUserName - account di accesso Amministrazione
string.

Specifica l'account di accesso amministratore per i computer di destinazione.
Ad esempio: Domain\Admin User, Admin User@Domain, .\Admin User.

AdminPassword - Password
string.

Specifica la password di amministratore per i computer di destinazione. Variabili definite nelle definizioni di compilazione $(passwordVariable) /versione 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 al servizio WinRM con i computer. Il valore predefinito è HTTPS.

TestCertificate - Testare il certificato
boolean. Facoltativa. Usare quando Protocol = Https. Valore predefinito: true.

Specifica l'opzione per ignorare 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 - 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 un parametro ordinale o denominato, 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.

Facoltativa. Specifica un subset di computer specificando nomi o 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 dell'attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

No.

Osservazioni

Novità della versione 2.0:

Rimozione del supporto dei computer DTL legacy.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito 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