WindowsProcess
Synopsis
Démarrez ou arrêtez un processus Windows.
Syntaxe
WindowsProcess [String] #ResourceName
{
Arguments = [string]
Path = [string]
[Credential = [PSCredential]]
[DependsOn = [string[]]]
[Ensure = [string]{ Absent | Present }]
[PsDscRunAsCredential = [PSCredential]]
[StandardErrorPath = [string]]
[StandardInputPath = [string]]
[StandardOutputPath = [string]]
[WorkingDirectory = [string]]
}
Description
La WindowsProcess ressource vous permet de vérifier si un processus est en cours d’exécution.
Configuration requise
Aucun.
Propriétés de la clé
Arguments
Spécifiez la liste complète des arguments à passer au processus lors du démarrage en tant que chaîne. Définissez cette propriété sur une chaîne vide ('') si le processus ne nécessite aucun argument.
Type: System.String
Chemin d’accès
Spécifiez le chemin d’accès au fichier exécutable du processus. Si le fichier est accessible via la PATH variable d’environnement, vous pouvez définir cette propriété sur le nom du fichier exécutable. Sinon, définissez cette propriété sur le chemin d’accès complet au fichier. Les chemins relatifs ne sont pas pris en charge.
Type: System.String
Propriétés facultatives
Informations d'identification
Spécifiez les informations d’identification du compte sous lesquelles exécuter le processus.
Si cette propriété est définie sur un compte système local, vous ne pouvez pas définir les propriétés StandardOutputPath, StandardInputPath ou WorkingDirectory . Si vous le faites, la ressource lève une exception d’argument non valide.
Type: System.Management.Automation.PSCredential
Default Value: None
Ensure
Spécifiez si le processus doit être en cours d’exécution. Définissez cette propriété pour Present démarrer le processus s’il n’est pas en cours d’exécution. Définissez cette propriété pour Absent arrêter le processus s’il est en cours d’exécution.
La valeur par défaut est Present.
Type: System.String
Accepted Values:
- Absent
- Present
Default Value: Present
StandardErrorPath
Spécifiez le chemin d’accès complet à un fichier dans lequel le processus doit écrire son flux d’erreurs standard. Les chemins relatifs ne sont pas pris en charge. Si le fichier existe, il est remplacé.
Ne définissez pas cette propriété lors de la définition de la propriété AbsentEnsure sur . Si vous le faites, la ressource lève une exception d’argument non valide.
Type: System.String
Default Value: None
StandardInputPath
Spécifiez le chemin d’accès complet à un fichier pour le processus à lire en tant que flux d’entrée standard. Les chemins relatifs ne sont pas pris en charge.
Ne définissez pas cette propriété lors de la définition de la propriété AbsentEnsure sur ou de la propriété Credential sur un compte système local. Si vous le faites, la ressource lève une exception d’argument non valide.
Type: System.String
Default Value: None
StandardOutputPath
Spécifiez le chemin d’accès complet à un fichier dans lequel le processus doit écrire son flux de sortie standard. Les chemins relatifs ne sont pas pris en charge. Si le fichier existe, il est remplacé.
Ne définissez pas cette propriété lors de la définition de la propriété AbsentEnsure sur ou de la propriété Credential sur un compte système local. Si vous le faites, la ressource lève une exception d’argument non valide.
Type: System.String
Default Value: None
WorkingDirectory
Spécifiez le chemin d’accès complet à un dossier pour le répertoire de travail du processus. Les chemins relatifs ne sont pas pris en charge.
Ne définissez pas cette propriété lors de la définition de la propriété AbsentEnsure sur ou de la propriété Credential sur un compte système local. Si vous le faites, la ressource lève une exception d’argument non valide.
Type: System.String
Default Value: None
Propriétés en lecture seule
HandleCount
Nombre de handles ouverts par le processus.
Type: System.Int32
Behavior: Read
NonPagedMemorySize
Quantité de mémoire non paginé, en octets, allouée pour le processus.
Type: System.UInt64
Behavior: Read
PagedMemorySize
Quantité de mémoire paginée, en octets, allouée pour le processus.
Type: System.UInt64
Behavior: Read
ProcessCount
Nombre d’instances du processus donné en cours d’exécution.
Type: System.Int32
Behavior: Read
ProcessId
Identificateur unique du processus.
Type: System.Int32
Behavior: Read
VirtualMemorySize
Quantité de mémoire virtuelle, en octets, allouée pour le processus.
Type: System.UInt64
Behavior: Read
