AzurePowerShell@2 - attività Azure PowerShell v2

Articolo
07/02/2024

Usare questa attività per eseguire uno script di PowerShell all'interno di un ambiente Azure. Il contesto di Azure viene autenticato con la connessione del servizio azure Resource Manager fornita.

Sintassi

# Azure PowerShell v2
# Run a PowerShell script within an Azure environment.
- task: AzurePowerShell@2
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    ScriptType: 'FilePath' # 'FilePath' | 'InlineScript'. Required. Script Type. Default: FilePath.
    #ScriptPath: # string. Optional. Use when ScriptType = FilePath. Script Path. 
    #Inline: # string. Optional. Use when ScriptType = InlineScript. Inline Script. 
    #ScriptArguments: # string. Script Arguments. 
    #azurePowerShellVersion: 'OtherVersion' # 'LatestVersion' | 'OtherVersion'. Alias: TargetAzurePs. Azure PowerShell Version. Default: OtherVersion.
    preferredAzurePowerShellVersion: # string. Alias: CustomTargetAzurePs. Required when TargetAzurePs = OtherVersion. Preferred Azure PowerShell Version.

Input

azureConnectionType - Tipo di connessione di Azure
Alias di input: ConnectedServiceNameSelector. string. Valori consentiti: ConnectedServiceName (versione classica di Azure), ConnectedServiceNameARM (Azure Resource Manager). Valore predefinito: ConnectedServiceNameARM.

azureClassicSubscription - Sottoscrizione classica di Azure
Alias di input: ConnectedServiceName. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName.

Sottoscrizione classica di Azure da configurare prima di eseguire PowerShell.

azureSubscription - Sottoscrizione di Azure
Alias di input: ConnectedServiceNameARM. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Sottoscrizione di Azure Resource Manager da configurare prima di eseguire PowerShell.

ScriptType - Tipo di script
string. Obbligatorio. Valori consentiti: FilePath (percorso file script), InlineScript (script inline script). Valore predefinito: FilePath.

Tipo di script: percorso del file o inline.

ScriptPath - Percorso script
string. Facoltativa. Usare quando ScriptType = FilePath.

Percorso dello script. Deve trattarsi di un percorso completo o di un percorso relativo alla directory di lavoro predefinita.

Inline - Inline Script
string. Facoltativa. Usare quando ScriptType = InlineScript. Valore predefinito: # You can write your azure powershell scripts inline here. \n# You can also pass predefined and custom variables to this script using arguments.

Specifica lo script da eseguire. La lunghezza massima supportata dello script inline è di 5000 caratteri. Usare uno script da un file se si vuole usare uno script più lungo.

ScriptArguments - Argomenti script
string.

Parametri aggiuntivi da passare a PowerShell. Questi parametri possono essere ordinali o denominati.

azurePowerShellVersion - versione Azure PowerShell
Alias di input: TargetAzurePs. string. Valori consentiti: LatestVersion (versione installata più recente), OtherVersion (specificare un'altra versione). Valore predefinito: OtherVersion.

Nel caso di agenti ospitati, i Azure PowerShell versioni supportati sono 2.1.0, 3.8.0, 4.2.15.1.1 e 6.7.0. Per selezionare la versione più recente disponibile nell'agente, selezionare LatestVersion (ultima versione installata).

Per gli agenti privati è possibile specificare una versione preferita di Azure PowerShell usando OtherVersion (specificare un'altra versione).

preferredAzurePowerShellVersion - Versione preferita Azure PowerShell
Alias di input: CustomTargetAzurePs. string. Obbligatorio quando TargetAzurePs = OtherVersion.

La versione Azure PowerShell preferita deve essere una versione semantica appropriata, ad esempio. 1.2.3.. L'espressione regolare come 2.\*,2.3.\* non è supportata. Gli agenti ospitati supportano attualmente le versioni dei moduli 2.1.0di Azure , 3.8.0, 4.2.15.1.1 e AzureRM 2.1.0, , 4.2.13.8.05.1.1, , . 6.7.0

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
Viene eseguito in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che soddisfano le richieste seguenti per eseguire processi che usano questa attività: azureps
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.95.0 o versione successiva
Categoria attività	Distribuire

Condividi tramite