À propos de ActivityCommonParameters

DESCRIPTION COURTE

Décrit les paramètres ajoutés par le workflow Windows PowerShell aux activités.

DESCRIPTION DÉTAILLÉE

Le flux de travail Windows PowerShell ajoute les paramètres communs de l’activité aux activités dérivées de la classe de base PSActivity. Cette catégorie inclut l’activité InlineScript et les applets de commande Windows PowerShell qui sont implémentées en tant qu’activités, telles que Get-Process et Get-WinEvent.

Les paramètres communs à l’activité ne sont pas valides sur les activités Suspend-Workflow et Checkpoint-Workflow et ils ne sont pas ajoutés aux applets de commande ou aux expressions que le flux de travail Windows PowerShell exécute automatiquement dans un bloc de script InlineScript ou une activité similaire. Les paramètres communs à l’activité sont disponibles sur l’activité InlineScript, mais pas sur les commandes du bloc de script InlineScript.

Plusieurs des paramètres communs d’activité sont également des paramètres courants de flux de travail ou des paramètres communs Windows PowerShell. D’autres paramètres communs d’activité sont uniques aux activités.

Pour plus d’informations sur les paramètres communs au flux de travail, reportez-vous à la about_WorkflowCommonParameters. Pour plus d’informations sur les paramètres communs de Windows PowerShell, consultez about_CommonParameters.

LISTE DES PARAMÈTRES COMMUNS DE L’ACTIVITÉ

AppendOutput                      PSDebug
Debug                             PSDisableSerialization
DisplayName                       PSDisableSerializationPreference
ErrorAction                       PSError
Input                             PSPersist
MergeErrorToOutput                PSPort
PSActionRetryCount                PSProgress
PSActionRetryIntervalSec          PSProgressMessage
PSActionRunningTimeoutSec         PSRemotingBehavior
PSApplicationName                 PSRequiredModules
PSAuthentication                  PSSessionOption
PSCertificateThumbprint           PSUseSSL
PSComputerName                    PSVerbose
PSConfigurationName               PSWarning
PSConnectionRetryCount            Result
PSConnectionRetryIntervalSec      UseDefaultInput
PSConnectionURI                   Verbose
PSCredential                      WarningAction

DESCRIPTIONS DES PARAMÈTRES

Cette section décrit les paramètres communs d’activité.

AppendOutput <booléen>

Une valeur d’ajout $True de la sortie de l’activité à la valeur de la variable. Une valeur de n’a $False aucun effet. Par défaut, l’attribution d’une valeur à une variable remplace la valeur de la variable.

Par exemple, les commandes suivantes ajoutent un objet de processus à l’objet de service dans la $x variable.

Workflow Test-Workflow
{
    $x = Get-Service
    $x = Get-Process -AppendOutput $true
}

Ce paramètre est conçu pour les flux de travail XAML. Dans les workflows de script, vous pouvez également utiliser l’opérateur d’affectation += pour ajouter une sortie à la valeur d’une variable, comme illustré dans l’exemple suivant.

Workflow Test-Workflow
{
    $x = Get-Service
    $x += Get-Process
}

Déboguer <SwitchParameter>

Affiche des détails au niveau du programmeur sur l’opération effectuée par la commande. Le paramètre Debug remplace la valeur de la variable $DebugPreference pour la commande actuelle. Ce paramètre ne fonctionne que lorsque la commande génère des messages de débogage. Ce paramètre est également un paramètre commun Windows PowerShell.

Chaîne DisplayName <>

Spécifie un nom convivial pour l’activité. La valeur DisplayName apparaît dans la barre de progression pendant l’exécution du flux de travail et dans la valeur de la propriété Progress du travail de flux de travail. Lorsque le paramètre PSProgressMessage est également inclus dans la commande, le contenu de la barre de progression s’affiche au <format DisplayName> :<PSProgressMessage> .

ErrorAction <ActionPreference>

Détermine la façon dont l’activité répond à une erreur de non-fin de la commande. Elle n’a aucun effet sur les erreurs d’arrêt. Ce paramètre ne fonctionne que lorsque la commande génère une erreur non terminative, telle que celles de l’applet de commande Write-Error. Le paramètre ErrorAction remplace la valeur de la variable $ErrorActionPreference pour la commande actuelle. Ce paramètre est également un paramètre commun Windows PowerShell.

Valeurs valides :

• Continuer. Affiche le message d’erreur et poursuit l’exécution de la commande. « Continuer » est la valeur par défaut.

• Ignorer. Supprime le message d’erreur et poursuit l’exécution de la commande. Contrairement à SilentlyContinue, Ignore n’ajoute pas le message d’erreur à la variable automatique $Error. La valeur Ignorer est introduite dans Windows PowerShell 3.0.

• Demander. Affiche le message d’erreur et vous invite à confirmer avant la poursuite de l’exécution. Cette valeur est rarement utilisée.

• Suspendre. Suspend automatiquement un travail de flux de travail pour permettre une investigation plus approfondie. Après examen, le flux de travail peut être repris.

• SilencieusementContinuer. Supprime le message d’erreur et poursuit l’exécution de la commande.

• Arrêter. Affiche le message d’erreur et arrête l’exécution de la commande.

Input <, objet[]>

Envoie une collection d’objets à une activité. Il s’agit d’une alternative à la canalisation des objets vers l’activité un à un.

MergeErrorToOutput <booléen>

Valeur d’ajout d’erreurs $True au flux de sortie. La valeur de n’a $False pas d’effet. Utilisez ce paramètre avec les mots-clés Parallel et ForEach -Parallel pour collecter les erreurs et les sorties de plusieurs commandes parallèles dans une seule collection.

PSActionRetryCount <Int32>

Tente à plusieurs reprises d’exécuter l’activité en cas d’échec de la première tentative. La valeur par défaut, 0, ne fait pas réessayer.

PSActionRetryIntervalSec <Int32>

Détermine l’intervalle entre les tentatives d’action en secondes. La valeur par défaut, 0, relance l’action immédiatement. Ce paramètre n’est valide que si le paramètre PSActionRetryCount est également utilisé dans la commande.

PSActionRunningTimeoutSec <Int32>

Détermine la durée pendant laquelle l’activité peut s’exécuter sur chaque ordinateur cible. Si l’activité ne se termine pas avant l’expiration du délai d’expiration, le flux de travail Windows PowerShell génère une erreur de fin et arrête le traitement du flux de travail sur l’ordinateur cible concerné.

PSAllowRedirection <booléen>

Une valeur de $True permet de rediriger la connexion vers les ordinateurs cibles. Une valeur de $False n’a aucun effet. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

Lorsque vous utilisez le paramètre PSConnectionURI, la destination distante peut renvoyer une instruction pour rediriger vers un autre URI. Par défaut, Windows PowerShell ne redirige pas les connexions, mais vous pouvez utiliser le paramètre PSAllowRedirection avec une valeur de $True pour autoriser la redirection de la connexion vers l’ordinateur cible.

Vous pouvez également limiter le nombre de fois que la connexion est redirigée en définissant la propriété MaximumConnectionRedirectionCount de la $PSSessionOption variable de préférence ou la propriété MaximumConnectionRedirectionCount de la valeur du paramètre SSessionOption des applets de commande qui créent une session. La valeur par défaut est 5.

Chaîne PSApplicationName <>

Spécifie le segment de nom d’application de l’URI de connexion utilisé pour se connecter aux ordinateurs cibles. Utilisez ce paramètre pour spécifier le nom de l’application lorsque vous n’utilisez pas le paramètre ConnectionURI dans la commande. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

La valeur par défaut est la valeur de la $PSSessionApplicationName variable de préférence sur l’ordinateur cible. Si cette variable de préférence n’est pas définie, la valeur par défaut est WSMAN. Cette valeur est appropriée pour la plupart des utilisations. Pour plus d'informations, consultez about_Preference_Variables.

Le service WinRM utilise le nom de l’application pour sélectionner un écouteur pour traiter la demande de connexion. La valeur de ce paramètre doit correspondre à la valeur de la propriété URLPrefix d’un écouteur sur l’ordinateur distant.

PSAuthentication <AuthenticationMechanism>

Spécifie le mécanisme utilisé pour authentifier les informations d’identification de l’utilisateur lors de la connexion aux ordinateurs cibles. Les valeurs valides sont Default, Basic, Credssp, Digest, Kerberos, Negotiate et NegotiateWithImplicitCredential. La valeur par défaut est Default. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

Pour plus d’informations sur les valeurs de ce paramètre, consultez la description de l’énumération System.Management.Automation.Runspaces.AuthenticationMechanism dans MSDN.

CHAÎNE PSCertificateThumbprint <>

Spécifie le certificat de clé publique numérique (X509) d’un compte d’utilisateur autorisé à effectuer cette action. Entrez l’empreinte numérique du certificat. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

Les certificats sont utilisés dans l’authentification basée sur les certificats client. Ils peuvent uniquement être mappés aux comptes d'utilisateurs locaux ; ils ne fonctionnent pas avec les comptes de domaine.

Pour obtenir un certificat, utilisez les applets de commande Get-Item ou Get-ChildItem dans le lecteur Windows PowerShell Cert :.

Chaîne PSComputerName <[]>

Spécifie les ordinateurs cibles sur lesquels l’activité s’exécute. La valeur par défaut est l’ordinateur local. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

Tapez le nom NETBIOS, l'adresse IP ou le nom de domaine complet d'un ou de plusieurs ordinateurs dans une liste séparée par des virgules. Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, « localhost » ou un point (.).

Pour inclure l’ordinateur local dans la valeur du paramètre PSComputerName, ouvrez Windows PowerShell avec l’option « Exécuter en tant qu’administrateur ».

Si ce paramètre est omis de la commande ou si sa valeur est $null ou une chaîne vide, la cible du flux de travail est l’ordinateur local et la communication à distance Windows PowerShell n’est pas utilisée pour exécuter la commande.

Pour utiliser une adresse IP dans la valeur du paramètre ComputerName, la commande doit inclure le paramètre PSCredential. En outre, l’ordinateur doit être configuré pour le transport HTTPS ou l’adresse IP de l’ordinateur distant doit être inclus dans la liste WinRM TrustedHosts sur l’ordinateur local. Pour obtenir des instructions sur l’ajout d’un nom d’ordinateur à la liste TrustedHosts, consultez « How to Add a Computer to the Trusted Host List » dans about_Remote_Troubleshooting.

Chaîne PSConfigurationName <>

Spécifie les configurations de session utilisées pour créer des sessions sur les ordinateurs cibles. Entrez le nom d’une configuration de session sur les ordinateurs cibles (et non sur l’ordinateur qui exécute le flux de travail). La valeur par défaut est Microsoft.PowerShell. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

PSConnectionRetryCount <UInt>

Spécifie le nombre maximal de tentatives de connexion à chaque ordinateur cible si la première tentative de connexion échoue. Entrez un nombre compris entre 1 et 4 294 967 295 (UInt.MaxValue). La valeur par défaut, zéro (0), représente l’absence de nouvelle tentative. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

PSConnectionRetryIntervalSec <UInt>

Spécifie le délai entre les tentatives de nouvelle tentative de connexion en secondes. La valeur par défaut est zéro (0). Ce paramètre n’est valide que lorsque la valeur de PSConnectionRetryCount est au moins 1. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

PSConnectionURI <System.Uri>

Spécifie un URI qui définit le point de terminaison de connexion de l’activité sur l’ordinateur cible. L’URI doit être complet. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

Le format de cette chaîne est le suivant :

<Transport>://<ComputerName>:<Port>/<ApplicationName>

La valeur par défaut est https://localhost:5985/WSMAN.

Si vous ne spécifiez pas de PSConnectionURI, vous pouvez utiliser les paramètres PSUseSSL, PSComputerName, PSPort et PSApplicationName pour spécifier les valeurs PSConnectionURI.

Les valeurs valides pour le segment Transport de l’URI sont HTTP et HTTPS. Si vous spécifiez un URI de connexion avec un segment de transport, mais que vous ne spécifiez pas de port, la session est créée avec des ports standards : 80 pour HTTP et 443 pour HTTPS. Pour utiliser les ports par défaut pour la communication à distance Windows PowerShell, spécifiez le port 5985 pour HTTP ou 5986 pour HTTPS.

PSCrédentiel <PSCrédentiel>

Spécifie un compte d’utilisateur autorisé à exécuter l’activité sur l’ordinateur cible. La valeur par défaut est l’utilisateur actuel. Ce paramètre n’est valide que lorsque le paramètre PSComputerName est inclus dans la commande. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

Tapez un nom d’utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez une variable qui contient un objet PSCredential, tel qu’un objet renvoyé par l’applet de commande Get-Credential. Si vous entrez uniquement un nom d’utilisateur, vous serez invité à entrer un mot de passe.

PSDebug <PSDataCollection[DebugRecord]>

Ajoute les messages de débogage de l’activité à la collection d’enregistrements de débogage spécifiée, au lieu d’écrire les messages de débogage dans la console ou dans la valeur de la propriété Debug du travail de flux de travail. Vous pouvez ajouter des messages de débogage de plusieurs activités au même objet de collection d’enregistrements de débogage.

Pour utiliser ce paramètre commun d’activité, utilisez l’applet de commande New-Object pour créer un objet PSDataCollection avec le type DebugRecord et enregistrer l’objet dans une variable. Ensuite, utilisez la variable comme valeur du paramètre PSDebug d’une ou plusieurs activités, comme illustré dans l’exemple suivant.

Workflow Test-Workflow
{
    $debugCollection = New-Object -Type `
    System.Management.Automation.PSDataCollection[System.Management.Automation.DebugRecord]
    InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSDebug $debugCollection -Debug $True
    InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSDebug $debugCollection -Debug $True
    if ($debugCollection -like "Missing") { ...}
}

PSDisableSerialization <Booléen>

Dirige l’activité pour retourner des objets « live » (non sérialisés) au flux de travail. Les objets ainsi générés ont des méthodes, ainsi que des propriétés, mais ils ne peuvent pas être enregistrés lorsqu’un point de contrôle est activé.

PSDisableSerializationPreference <booléen>

Applique l’équivalent du paramètre PSDisableSerialization à l’ensemble du flux de travail, et pas seulement à l’activité. L’ajout de ce paramètre n’est généralement pas recommandé, car un flux de travail qui ne sérialise pas ses objets ne peut pas être repris ou conservé.

Valeurs valides :

• (Par défaut) S’il est omis et que vous n’avez pas non plus ajouté le paramètre PSDisableSerialization à une activité, les objets sont sérialisés.

• $True. Indique à toutes les activités au sein d’un workflow de retourner les objets « dynamiques » (non sérialisés). Les objets ainsi générés ont des méthodes, ainsi que des propriétés, mais ils ne peuvent pas être enregistrés lorsqu’un point de contrôle est activé.

• $False. Les objets de workflow sont sérialisés.

PSError <PSDataCollection[ErrorRecord]>

Ajoute les messages d’erreur de l’activité à la collection d’enregistrements d’erreurs spécifiée, au lieu d’écrire les messages d’erreur dans la console ou dans la valeur de la propriété Error du travail de workflow. Vous pouvez ajouter des messages d’erreur de plusieurs activités au même objet de collection d’enregistrements d’erreur.

Pour utiliser ce paramètre commun d’activité, utilisez l’applet New-Object de commande pour créer un objet PSDataCollection avec le type ErrorRecord et enregistrer l’objet dans une variable. Ensuite, utilisez la variable comme valeur du paramètre PSError d’une ou plusieurs activités, comme illustré dans l’exemple suivant.

Workflow Test-Workflow
{
   $typeName = "System.Management.Automation.PSDataCollection"
   $typeName += '[System.Management.Automation.ErrorRecord]'
   $ec = New-Object $typeName
   InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSError $ec
   InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSError $ec
   if ($ec.Count -gt 2)
   {
      # Do Some Work.
   }
}

PSPersist <Booléen>

Prend un point de contrôle après l’activité. Ce point de contrôle est ajouté aux points de contrôle spécifiés dans le flux de travail. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

Un « point de contrôle » ou « point de persistance » est un instantané de l’état du flux de travail et des données capturées pendant l’exécution du flux de travail et enregistré dans un magasin de persistance sur le disque. Windows PowerShell Workflow utilise les données enregistrées pour reprendre un flux de travail suspendu ou interrompu à partir du dernier point de persistance, plutôt que de redémarrer le flux de travail.

Valeurs valides :

• (Par défaut) Si vous omettez ce paramètre, aucun point de contrôle n’est ajouté. Les points de contrôle sont pris en fonction des paramètres du flux de travail.

• $True. Applique un point de contrôle une fois l’activité terminée. Ce point de contrôle est ajouté aux points de contrôle spécifiés dans le flux de travail.

• $False. Aucun point de contrôle n’est ajouté. Les points de contrôle sont pris uniquement lorsqu’ils sont spécifiés dans le flux de travail.

PSPort <Int32>

Spécifie le port réseau sur les ordinateurs cibles. Les ports par défaut sont 5985 (port WinRM pour HTTP) et 5986 (port WinRM pour HTTPS). Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

N’utilisez pas le paramètre PSPort à moins que vous ne le deviez. Le port défini dans la commande s’applique à tous les ordinateurs ou sessions sur lesquels la commande s’exécute. Un autre paramètre de port peut empêcher l’exécution de la commande sur tous les ordinateurs. Avant d’utiliser un autre port, vous devez configurer l’écouteur WinRM sur l’ordinateur distant pour écouter sur ce port.

PSProgress <PSDataCollection[ProgressRecord]>

Ajoute les messages de progression de l’activité à la collection d’enregistrements de progression spécifiée, au lieu d’écrire les messages de progression dans la console ou dans la valeur de la propriété Progress du travail de workflow. Vous pouvez ajouter des messages de progression de plusieurs activités au même objet de collection d’enregistrements de progression.

Chaîne PSProgressMessage <>

Spécifie une description conviviale de l’activité. La valeur PSProgressMessage s’affiche dans la barre de progression pendant l’exécution du flux de travail. Lorsque DisplayName est également inclus dans la commande, le contenu de la barre de progression s’affiche au <format DisplayName> :<PSProgressMessage> .

Ce paramètre est particulièrement utile pour identifier les activités dans un bloc de script -Parallel ForEach. Sans ce message, les activités de toutes les branches parallèles sont identifiées par le même nom.

PSRemotingBehavior RemotingBehavior <>

Spécifie la façon dont la communication à distance est gérée lorsque l’activité est exécutée sur des ordinateurs cibles. PowerShell est la valeur par défaut.

Les valeurs valides sont les suivantes :

• Aucun : l’activité n’est pas exécutée sur des ordinateurs distants.

• PowerShell : la communication à distance Windows PowerShell est utilisée pour exécuter l’activité sur les ordinateurs cibles.

• Personnalisé : l’activité prend en charge son propre type de communication à distance. Cette valeur est valide lorsque l’applet de commande en cours d’implémentation en tant qu’activité définit la valeur de l’attribut RemotingCapability sur SupportedByCommand et que la commande inclut le paramètre ComputerName.

Chaîne PSRequiredModules <[]>

Importe les modules spécifiés avant d’exécuter la commande. Entrez les noms des modules. Les modules doivent être installés sur l’ordinateur cible.

Les modules installés dans un chemin spécifié dans la variable d’environnement PSModulePath sont automatiquement importés lors de la première utilisation d’une commande du module. Utilisez ce paramètre pour importer des modules qui ne se trouvent pas dans un emplacement PSModulePath.

Étant donné que chaque activité d’un flux de travail s’exécute dans sa propre session, une commande Import-Module importe un module uniquement dans la session dans laquelle il s’exécute. Elle n’importe pas le module dans des sessions dans lesquelles d’autres activités sont exécutées.

PSSessionOption <PSSessionOption>

Définit les options avancées pour les sessions sur les ordinateurs cibles. Entrez un objet PSSessionOption, tel qu’un objet que vous créez à l’aide de l’applet de commande New-PSSessionOption. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

Les valeurs par défaut des options de session sont déterminées par la valeur de la $PSSessionOption variable de préférence, si elle est définie. Sinon, la session utilise les valeurs spécifiées dans la configuration de session.

Pour obtenir une description des options de session, y compris les valeurs par défaut, consultez la rubrique d’aide de l’applet de commande New-PSSessionOption New-PSSessionOption.

Pour plus d’informations sur la variable de préférence $PSSessionOption, consultez about_Preference_Variables.

PSUseSSL <booléen>

Une valeur de $True utilise le protocole SSL (Secure Sockets Layer) pour établir une connexion à l’ordinateur cible. Par défaut, SSL n’est pas utilisé. Une valeur de $False n’a aucun effet. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

WS-Management chiffre tout le contenu Windows PowerShell transmis sur le réseau. UseSSL est une protection supplémentaire qui envoie les données via HTTPS, au lieu de HTTP. Si vous utilisez ce paramètre, mais que SSL n’est pas disponible sur le port utilisé pour la commande, la commande échoue.

PSVerbose <PSDataCollection[VerboseRecord]>

Ajoute des messages détaillés de l’activité à la collection d’enregistrements détaillés spécifiée, au lieu d’écrire les messages détaillés dans la console ou dans la valeur de la propriété Verbose du travail de flux de travail. Vous pouvez ajouter des messages en clair de plusieurs activités au même objet de collection d’enregistrements en clair.

PSWarning <PSDataCollection[WarningRecord]>

Ajoute des messages d’avertissement de l’activité à la collection d’enregistrements d’avertissement spécifiée, au lieu d’écrire les messages d’avertissement dans la console ou dans la valeur de la propriété Warning du travail de flux de travail. Vous pouvez ajouter des messages d’avertissement de plusieurs activités au même objet de collection d’enregistrements d’avertissement.

Résultat

Ce paramètre est valide uniquement dans les flux de travail XAML.

UseDefaultInput <booléen>

Accepte toutes les entrées de flux de travail comme entrée de l’activité par valeur.

Par exemple, l’activité Get-Process dans l’exemple de flux de travail suivant utilise le paramètre commun d’activité UseDefaultInput pour obtenir l’entrée qui est transmise au flux de travail. Lorsque vous exécutez le workflow avec l’entrée, cette dernière est utilisée par l’activité.

workflow Test-Workflow
{
    Get-Service -UseDefaultInput $True
}

PS C:> Test-Workflow -InputObject WinRm

Status   Name        DisplayName                            PSComputerName
------   ----        -----------                            --------------
Running  winrm       Windows Remote Management (WS-Manag... localhost

<SwitchParameter détaillé>

Affiche des informations détaillées sur l’opération effectuée par la commande. Ces informations ressemblent aux informations d’une trace ou dans un journal des transactions. Le paramètre Verbose remplace la valeur de la variable $VerbosePreference pour la commande actuelle. Ce paramètre ne fonctionne que lorsque la commande génère un message détaillé. Ce paramètre est également un paramètre commun Windows PowerShell.

AvertissementAction <ActionPréférence>

Détermine la façon dont l’activité répond à un avertissement. « Continuer » est la valeur par défaut. Le paramètre WarningAction remplace la valeur de la variable $WarningPreference pour la commande actuelle. Ce paramètre ne fonctionne que lorsque la commande génère un message d’avertissement. Ce paramètre est également un paramètre commun Windows PowerShell.

Valeurs correctes :

• SilencieusementContinuer. Supprime le message d’avertissement et poursuit l’exécution de la commande.

• Continuer. Affiche le message d’avertissement et poursuit l’exécution de la commande. « Continuer » est la valeur par défaut.

• Demander. Affiche le message d’avertissement et vous invite à confirmer avant la poursuite de l’exécution. Cette valeur est rarement utilisée.

• Arrêter. Affiche le message d’avertissement et arrête l’exécution de la commande.

EXEMPLES

Les paramètres communs d’activité sont extrêmement utiles. Par exemple, vous pouvez utiliser le paramètre PSComputerName pour exécuter des activités particulières uniquement sur un sous-ensemble des ordinateurs cibles.

Vous pouvez également utiliser les paramètres PSConnectionRetryCount et PSConnectionRetryIntervalSec pour ajuster les valeurs de nouvelle tentative pour des activités particulières.

L’exemple suivant montre comment utiliser les paramètres communs de l’activité PSComputerName pour exécuter une activité Get-EventLog uniquement sur les ordinateurs d’un domaine particulier.

Workflow Test-Workflow
{
    $UserDomain = Get-Content -Path '.\UserComputers.txt'
    $Log = (Get-EventLog -LogName "Windows PowerShell" `
      -PSComputerName $UserDomain)

    if ($Log)
    {
        # Do Work Here.
    }
}

VOIR AUSSI

about_Workflowsabout_WorkflowCommonParameters