definizione steps.pwsh

Il passaggio pwsh esegue uno script in PowerShell Core in Windows, macOS e Linux.

steps:
- pwsh: string # Required as first property. Inline PowerShell script.
  errorActionPreference: string # Unless otherwise specified, the error action preference defaults to the value stop. See the following section for more information.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  ignoreLASTEXITCODE: string # Check the final exit code of the script to determine whether the step succeeded?
  workingDirectory: string # Start the script with this working directory.
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

Definizioni che fanno riferimento a questa definizione: passaggi

Proprietà

pwsh stringa. Obbligatorio come prima proprietà.
script di PowerShell inline.

errorActionPreference stringa.
Se non diversamente specificato, per impostazione predefinita la preferenza per l'azione di errore corrisponde al valore stop. Per altre informazioni, vedere la sezione seguente.

failOnStderr stringa.
Non eseguire l'attività se l'output viene inviato a Stderr?

ignoreLASTEXITCODE stringa.
Controllare il codice di uscita finale dello script per determinare se il passaggio è riuscito?

workingDirectory stringa.
Avviare lo script con questa directory di lavoro.

condition stringa.
Valutare questa espressione di condizione per determinare se eseguire questa attività.

continueOnError booleano .
Continuare l'esecuzione anche in caso di errore?

displayName stringa.
nome leggibile per l'attività.

target destinazione.
Ambiente in cui eseguire questa attività.

enabled booleano .
Esegui questa attività quando viene eseguito il processo?

env dizionario di stringhe.
Variabili di cui eseguire il mapping nell'ambiente del processo.

name stringa.
ID del passaggio. Valori accettabili: [-_A-Za-z0-9]*.

timeoutInMinutes stringa.
Tempo di attesa per il completamento dell'attività prima che il server lo uccida.

Nota

Le pipeline possono essere configurate con un timeout a livello di processo. Se l'intervallo di timeout a livello di processo è trascorso prima del completamento del passaggio, il processo in esecuzione (incluso il passaggio) viene terminato, anche se il passaggio è configurato con un intervallo di timeoutInMinutes più lungo. Per altre informazioni, vedere timeout.

retryCountOnTaskFailure stringa.
Numero di tentativi in caso di errore dell'attività.

Osservazioni:

La parola chiave pwsh è un collegamento per l'attività di PowerShell quando il valore pwsh dell'attività è impostato su true. L'attività esegue uno script in PowerShell Core in Windows, macOS e Linux.

Altre informazioni sulle condizioni di e i timeout di .

Ogni sessione di PowerShell dura solo per la durata del processo in cui viene eseguita. Le attività che dipendono da ciò che è stato avviato devono trovarsi nello stesso processo del bootstrap.

Esempi

steps:
- pwsh: Write-Host Hello $($env:name)
  displayName: Say hello
  name: firstStep
  workingDirectory: $(build.sourcesDirectory)
  failOnStderr: true
  env:
    name: Microsoft

Vedere anche

• 'attività di PowerShell
• Altre informazioni sulle condizioni di e timeout