about_ActivityCommonParameters

Article
10/04/2023

DESCRIPTION COURTE

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

DESCRIPTION DÉTAILLÉE

Windows PowerShell Workflow ajoute les paramètres communs d’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 implémentées en tant qu’activités, telles que Get-Process et Get-WinEvent.

Les paramètres courants d’activité ne sont pas valides sur les Suspend-Workflow activités et Checkpoint-Workflow ne sont pas ajoutés aux applets de commande ou aux expressions que Windows PowerShell Workflow s’exécute automatiquement dans un bloc de script InlineScript ou une activité similaire. Les paramètres communs d’activité sont disponibles sur l’activité InlineScript , mais pas sur les commandes figurant dans le 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 courants du flux de travail, consultez about_WorkflowCommonParameters. Pour plus d’informations sur les paramètres courants 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 <Boolean>

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 flux de travail de script, vous pouvez également utiliser l’opérateur += d’affectation pour ajouter la 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 $DebugPreference variable pour la commande active. 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 que le flux de travail s’exécute et dans la valeur de la propriété Progression 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 <DisplayName>:<PSProgressMessage> format.

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 sans fin, telle que celle de l’applet Write-Error de commande. Le paramètre ErrorAction remplace la valeur de la $ErrorActionPreference variable pour la commande active. Ce paramètre est également un paramètre commun Windows PowerShell.

Valeurs correctes :

Continue. Affiche le message d’erreur et poursuit l’exécution de la commande. Continue est la valeur par défaut.
Ignore. Supprime le message d’erreur et poursuit l’exécution de la commande. Contrairement SilentlyContinueà , Ignore n’ajoute pas le message d’erreur à la $Error variable automatique. La Ignore valeur est introduite dans Windows PowerShell 3.0.
Inquire. Affiche le message d’erreur et vous invite à confirmer avant la poursuite de l’exécution. Cette valeur est rarement utilisée.
Suspend. Suspend automatiquement un travail de flux de travail pour permettre une investigation plus approfondie. Après examen, le flux de travail peut être repris.
SilentlyContinue. Supprime le message d’erreur et poursuit l’exécution de la commande.
Stop. 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 <Boolean>

Valeur d’ajout d’erreurs $True au flux de sortie. Une valeur de n’a $False aucun effet. Utilisez ce paramètre avec parallel et ForEach -Parallel mot clé s pour collecter des erreurs et des sorties à partir de plusieurs commandes parallèles dans une collection unique.

PSActionRetryCount <Int32>

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

PSActionRetryIntervalSec <Int32>

Détermine l’intervalle entre les tentatives d’action en secondes. Valeur par défaut, 0, réessaye immédiatement l’action. Ce paramètre est valide uniquement lorsque 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 <Boolean>

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

Lorsque vous utilisez le paramètre PS Connecter ionURI, la destination distante peut retourner 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 la valeur permettant de $True rediriger la connexion vers l’ordinateur cible.

Vous pouvez également limiter le nombre de fois où la connexion est redirigée en définissant la propriété Maximum Connecter ionRedirectionCount de la $PSSessionOption variable de préférence ou la propriété Maximum Connecter ionRedirectionCount de la valeur du paramètre SessionOption 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 Connecter ionURI 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 convient 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 port d'écoute et 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 le Kit de développement logiciel (SDK) PowerShell.

Avertissement

L’authentification CredSSP (Credential Security Service Provider), dans laquelle les informations d’identification de l’utilisateur sont transmises à un ordinateur distant à authentifier, est conçue pour les commandes qui nécessitent une authentification sur plusieurs ressources, telles que l’accès à un partage réseau distant. Ce mécanisme augmente le risque de sécurité lié à l'opération distante. Si l'ordinateur distant n'est pas fiable, les informations d'identification qui lui sont passées peuvent être utilisées pour contrôler la session réseau.

CHAÎNE PSCertificateThumbprint <>

Spécifie le certificat de clé publique numérique (X509) d'un compte d'utilisateur qui a l'autorisation d'exécuter 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 par certificat 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: .

PSComputerName <String[]>

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, localhostou 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 à partir de la commande, ou s’il s’agit $null d’une chaîne vide, la cible de 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 incluse dans la liste TrustedHosts pour WinRM de 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 exécutant le flux de travail). La valeur par défaut est Microsoft.PowerShell.Workflow. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

PS Connecter ionRetryCount <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), ne représente aucune tentative de nouvelle tentative. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

PS Connecter ionRetryIntervalSec <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 est valide uniquement lorsque la valeur de PS Connecter ionRetryCount est au moins 1. Ce paramètre commun d’activité est également un paramètre commun de flux de travail.

PS Connecter ionURI <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 http://localhost:5985/WSMAN.

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

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 http ou 5986 https.

PSCredential <PSCredential>

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 est valide uniquement 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 retourné par l’applet Get-Credential de commande. Si vous entrez uniquement un nom d’utilisateur, vous êtes invité à entrer un mot de passe.

PSDebug <PSDataCollection[DebugRecord]>

Ajoute des 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 à 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 New-Object de commande pour créer un objet PSDataCollection avec un type de DebugRecord et enregistrez 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 <Boolean>

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 <Boolean>

Applique l’équivalent du paramètre PSDisableSerialization à l’ensemble du workflow, 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 correctes :

(Par défaut) S’il est omis et que vous n’avez pas 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 des 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 à la valeur de la propriété Error du travail de flux de travail. 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 un 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 <Boolean>

Prend un point de case activée après l’activité. Ce point case activée est en plus des case activée points 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 persistance » ou « case activée point » est une instantané de l’état du flux de travail et des données capturées pendant l’exécution du flux de travail et enregistrée 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 correctes :

(Par défaut) Si vous omettez ce paramètre, aucun case activée points 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 case activée est en plus des case activée points spécifiés dans le flux de travail.
$False. Aucun case activée points 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 (le port WinRM pour HTTP) et 59'86 (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 , sauf si vous devez. 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 la commande de s'exécuter sur tous les ordinateurs. Avant d'utiliser un autre port, vous devez configurer l'écouteur WinRM sur l'ordinateur distant pour qu'il écoute sur ce port.

PSProgress <PSDataCollection[ProgressRecord]>

Ajoute des 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 à la valeur de la propriété Progression du travail de flux de travail. 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 apparaît 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 <DisplayName>:<PSProgressMessage> format.

Ce paramètre est particulièrement utile pour identifier les activités dans un ForEach -Parallel bloc de script. 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 :

None: 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.
Custom: l’activité prend en charge son propre type de communication à distance. Cette valeur est valide lorsque l’applet de commande implémentée en tant qu’activité définit la valeur de l’attribut RemotingCapability sur SupportedByCommand et que la commande inclut le paramètre ComputerName .

PSRequiredModules <String[]>

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 d’accès spécifié dans la variable d’environnement PSModulePath sont automatiquement importés lors de la première utilisation de n’importe quelle 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 Import-Module commande 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 New-PSSessionOption de commande. 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 $PSSessionOption variable de préférence, consultez about_Preference_Variables.

PSUseSSL <Boolean>

Valeur d’utilisation $True du protocole SSL (Secure Sockets Layer) pour établir une connexion à l’ordinateur cible. Par défaut, SSL n'est pas utilisé. Une valeur de n’a $False 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 sur un protocole 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, celle-ci échoue.

PSVerbose <PSDataCollection[VerboseRecord]>

Ajoute des messages détaillés de l’activité à la collection d’enregistrements détaillée spécifiée, au lieu d’écrire les messages détaillés dans la console ou à 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 à la valeur de la propriété Avertissement 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.

Result

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

UseDefaultInput <Boolean>

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 une entrée 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 $VerbosePreference variable 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.

WarningAction <ActionPreference>

Détermine la façon dont l’activité répond à un avertissement. Continue est la valeur par défaut. Le paramètre WarningAction remplace la valeur de la $WarningPreference variable pour la commande active. 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 :

SilentlyContinue. Supprime le message d’avertissement et poursuit l’exécution de la commande.
Continue. Affiche le message d’avertissement et poursuit l’exécution de la commande. Continue est la valeur par défaut.
Inquire. Affiche le message d’avertissement et vous invite à confirmer avant la poursuite de l’exécution. Cette valeur est rarement utilisée.
Stop. Affiche le message d’avertissement et arrête l’exécution de la commande.

Remarque

Le paramètre WarningAction ne remplace pas la valeur de la $WarningAction variable de préférence lorsque le paramètre est utilisé dans une commande pour exécuter un script ou une fonction.

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 PS Connecter ionRetryCount et PS Connecter ionRetryIntervalSec 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 Get-EventLog activité uniquement sur les ordinateurs qu’il contient 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.
    }
}

about_ActivityCommonParameters

DESCRIPTION COURTE

DESCRIPTION DÉTAILLÉE

LISTE DES PARAMÈTRES COMMUNS DE L’ACTIVITÉ

DESCRIPTIONS DES PARAMÈTRES

AppendOutput <Boolean>

Déboguer <SwitchParameter>

Chaîne DisplayName <>

ErrorAction <ActionPreference>

Input <, objet[]>

MergeErrorToOutput <Boolean>

PSActionRetryCount <Int32>

PSActionRetryIntervalSec <Int32>

PSActionRunningTimeoutSec <Int32>

PSAllowRedirection <Boolean>

Chaîne PSApplicationName <>

PSAuthentication <AuthenticationMechanism>

CHAÎNE PSCertificateThumbprint <>

PSComputerName <String[]>

Chaîne PSConfigurationName <>

PS Connecter ionRetryCount <UInt>

PS Connecter ionRetryIntervalSec <UInt>

PS Connecter ionURI <System.Uri>

PSCredential <PSCredential>

PSDebug <PSDataCollection[DebugRecord]>

PSDisableSerialization <Boolean>

PSDisableSerializationPreference <Boolean>

PSError <PSDataCollection[ErrorRecord]>

PSPersist <Boolean>

PSPort <Int32>

PSProgress <PSDataCollection[ProgressRecord]>

Chaîne PSProgressMessage <>

PSRemotingBehavior RemotingBehavior <>

PSRequiredModules <String[]>

PSSessionOption <PSSessionOption>

PSUseSSL <Boolean>

PSVerbose <PSDataCollection[VerboseRecord]>

PSWarning <PSDataCollection[WarningRecord]>

Result

UseDefaultInput <Boolean>

<SwitchParameter détaillé>

WarningAction <ActionPreference>

EXEMPLES

Voir aussi

Commentaires

Ressources supplémentaires