PowerShellOnTargetMachines@1 - Tâche PowerShell sur les machines cibles v1

Article
07/02/2024

Utilisez cette tâche pour exécuter des scripts PowerShell sur des ordinateurs distants.

Syntax

# 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.

Entrées

EnvironmentName - Machines
string. Obligatoire.

Spécifie une liste séparée par des virgules d’adresses IP ou de noms de domaine complets de l’ordinateur, ainsi que des ports. Le port par défaut est basé sur le protocole sélectionné.
Par exemple : dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
Vous pouvez également fournir la variable de sortie d’autres tâches, par exemple $(variableName). Si vous utilisez HTTPS, le nom ou l’adresse IP de l’ordinateur doit correspondre au CN dans le certificat.

AdminUserName - Connexion administrateur
string.

Spécifie la connexion administrateur pour les machines cibles.

AdminPassword - Mot de passe
string.

Spécifie le mot de passe administrateur pour les machines cibles. Variables définies dans les définitions de build/mise en production telles qu’elles $(passwordVariable) sont acceptées. Vous pouvez marquer le type de variable comme secret pour le sécuriser.

Protocol - Protocole
string. Valeurs autorisées : Http, Https.

Spécifie le protocole à utiliser pour la connexion WinRM avec les machines. La valeur par défaut est HTTPS.

TestCertificate - Certificat de test
boolean. facultatif. Utilisez quand Protocol = Https. Valeur par défaut : true.

Ignore la validation de l’authenticité du certificat de la machine par une autorité de certification approuvée. Le paramètre est requis pour le protocole HTTPS WinRM.

ScriptPath - PowerShell Script
string. Obligatoire.

Spécifie l’emplacement du script PowerShell sur les machines cibles ou sur un chemin UNC, comme C:\BudgetIT\Web\Deploy\Website.ps1.

ScriptArguments - Script Arguments
string.

Spécifie les arguments du script PowerShell. Il peut s’agir de paramètres ordinaux ou nommés, comme -testParam le test.

InitializationScriptPath - Script d’initialisation
string.

Spécifie l’emplacement du script de données pour DSC sur les ordinateurs cibles ou sur un chemin UNC, comme C:\BudgetIT\Web\Deploy\WebsiteConfiguration.ps1.

SessionVariables - Session Variables
string.

Spécifie les variables de session courantes pour les deux scripts. Par exemple, $variable = value ou $var1 = "value, 123".

RunPowershellInParallel - Exécuter PowerShell en parallèle
boolean. Valeur par défaut : true.

Si la valeur est définie truesur , exécute les scripts PowerShell en parallèle sur les machines cibles.

ResourceFilteringMethod - Sélectionner les machines par
string. Valeurs autorisées : machineNames (Noms des machines), tags. Valeur par défaut : machineNames.

facultatif. Spécifie un sous-ensemble de machines en fournissant des noms d’ordinateurs ou des balises.

MachineNames - Critères de filtre
string.

Cette entrée est valide uniquement pour les groupes d’ordinateurs ou les variables de sortie. Il n’est pas encore pris en charge pour une liste plate de machines.

Spécifie une liste de machines, telles que dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 ou des balises, telles que Role:DB; OS:Win8.1. Si plusieurs balises sont spécifiées, la tâche s’exécute sur toutes les machines avec les balises spécifiées. La valeur par défaut exécute la tâche dans tous les ordinateurs.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	1.104.0 ou version ultérieure
Catégorie de la tâche	Déployer

Partager via