WindowsProcess

  • Article

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

Exemples