ProcessSet

Article
05/05/2023

Synopsis

Gérez plusieurs processus Windows avec des paramètres courants.

Syntaxe

ProcessSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Path = [String[]]
    [Ensure = [String]]
    [Credential = [PSCredential]]
    [StandardOutputPath = [String]]
    [StandardErrorPath = [String]]
    [StandardInputPath = [String]]
    [WorkingDirectory = [String]]
}

Description

La ProcessSet ressource composite vous permet de configurer plusieurs processus Windows avec un ensemble limité d’options courantes. Pour gérer les processus avec plus de contrôle, notamment la possibilité de passer des arguments au processus, utilisez la ressource WindowsProcess.

Configuration requise

Aucun.

Propriétés de la clé

Chemin d’accès

Spécifiez les chemins d’accès aux fichiers exécutables des processus. Si un fichier est accessible via la PATH variable d’environnement, vous pouvez spécifier le nom du fichier. Sinon, spécifiez le chemin d’accès complet au fichier. Les chemins relatifs ne sont pas pris en charge.

Type: System.String[]
Behavior: Key

Propriétés facultatives

Informations d'identification

Spécifiez les informations d’identification du compte sous lesquelles exécuter les 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 les processus doivent être en cours d’exécution. Définissez cette propriété pour Present démarrer les processus s’ils ne sont pas en cours d’exécution. Définissez cette propriété pour Absent arrêter les processus s’ils sont 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 les processus écrivent leurs flux d’erreur 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 que les processus lisent 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 les processus écrivent leurs flux de sortie standard. Les chemins relatifs ne sont pas pris en charge. Si le fichier existe, il est remplacé.

Type: System.String
Default Value: None

WorkingDirectory

Spécifiez le chemin d’accès complet à un dossier pour le répertoire de travail des processus. Les chemins relatifs ne sont pas pris en charge.

Type: System.String
Default Value: None

Propriétés en lecture seule

HandleCount

Nombre de handles ouverts par les processus.

Type: System.SInt32
Behavior: Read

NonPagedMemorySize

Quantité de mémoire non paginé, en octets, allouée pour les processus.

Type: System.UInt64
Behavior: Read

PagedMemorySize

Quantité de mémoire paginée, en octets, allouée pour les processus.

Type: System.UInt64
Behavior: Read

ProcessCount

Nombre d’instances des processus donnés en cours d’exécution.

Type: System.SInt32
Behavior: Read

ProcessId

Identificateur unique des processus.

Type: System.SInt32
Behavior: Read

VirtualMemorySize

Quantité de mémoire virtuelle, en octets, allouée pour les processus.

Type: System.UInt64
Behavior: Read