Partager via


PowerShellOnTargetMachines@2 - Tâche PowerShell sur les machines cibles v2

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

Syntaxe

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

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 des ordinateurs, 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 nom commun dans le certificat.


AdminUserName - connexion Administration
string.

Spécifie la connexion administrateur pour les ordinateurs cibles.
Par exemple : Domain\Admin User, Admin User@Domain, .\Admin User.


AdminPassword - Mot de passe
string.

Spécifie le mot de passe administrateur pour les machines cibles. Les variables définies dans les définitions de build/mise en production sont $(passwordVariable) 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 de service WinRM avec les machines. La valeur par défaut est HTTPS.


TestCertificate - Tester le certificat
boolean. facultatif. Utilisez quand Protocol = Https. Valeur par défaut : true.

Spécifie l’option permettant d’ignorer la validation de l’authenticité du certificat de l’ordinateur 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 ordinateurs 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 test.


InitializationScriptPath - Script d’initialisation
string.

Spécifie l’emplacement du script de données pour DSC sur les machines 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 trueest définie sur , exécute les scripts PowerShell en parallèle sur les ordinateurs cibles.


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

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


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, comme Role:DB; OS:Win8.1. Si plusieurs balises sont spécifiées, la tâche s’exécute sur tous les ordinateurs avec les balises spécifiées. La valeur par défaut exécute la tâche sur tous les ordinateurs.


Options de contrôle des tâches

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.

Notes

Nouveautés de la version 2.0 :

  • Suppression de la prise en charge des machines DTL héritées.

Spécifications

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