ProcessSet

Artículo
05/05/2023

Sinopsis

Administrar varios procesos de Windows con una configuración común.

Sintaxis

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

Descripción

El ProcessSet recurso compuesto permite configurar varios procesos de Windows con un conjunto limitado de opciones comunes. Para administrar procesos con más control, incluida la capacidad de pasar argumentos al proceso, use el recurso WindowsProcess.

Requisitos

Ninguno.

Propiedades de la clave

Ruta de acceso

Especifique las rutas de acceso a los archivos ejecutables de los procesos. Si se puede acceder a un archivo a través de la PATH variable de entorno, puede especificar el nombre del archivo. De lo contrario, especifique la ruta de acceso completa al archivo. No se admiten rutas de acceso relativas.

Type: System.String[]
Behavior: Key

Propiedades opcionales

Credential:

Especifique la credencial de la cuenta en la que se ejecutarán los procesos.

Si esta propiedad se establece en una cuenta de sistema local, no se pueden establecer las propiedades StandardOutputPath, StandardInputPath o WorkingDirectory . Si lo hace, el recurso produce una excepción de argumento no válida.

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Especifique si los procesos deben ejecutarse. Establezca esta propiedad Present en para iniciar los procesos si no se están ejecutando. Establezca esta propiedad Absent en para detener los procesos si se están ejecutando.

El valor predeterminado es Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

StandardErrorPath

Especifique la ruta de acceso completa a un archivo para que los procesos escriban sus secuencias de error estándar. No se admiten rutas de acceso relativas. Si el archivo existe, se sobrescribe.

No establezca esta propiedad al establecer la propiedad AbsentEnsure en . Si lo hace, el recurso produce una excepción de argumento no válida.

Type: System.String
Default Value: None

StandardInputPath

Especifique la ruta de acceso completa a un archivo para que los procesos lean como su flujo de entrada estándar. No se admiten rutas de acceso relativas.

No establezca esta propiedad al establecer la propiedad AbsentEnsure en o la propiedad Credential en una cuenta del sistema local. Si lo hace, el recurso produce una excepción de argumento no válida.

Type: System.String
Default Value: None

StandardOutputPath

Especifique la ruta de acceso completa a un archivo en el que los procesos escribirán sus flujos de salida estándar. No se admiten rutas de acceso relativas. Si el archivo existe, se sobrescribe.

Type: System.String
Default Value: None

WorkingDirectory

Especifique la ruta de acceso completa a una carpeta para el directorio de trabajo de los procesos. No se admiten rutas de acceso relativas.

Type: System.String
Default Value: None

Propiedades de solo lectura

HandleCount

Número de identificadores abiertos por los procesos.

Type: System.SInt32
Behavior: Read

NonPagedMemorySize

Cantidad de memoria no paginada, en bytes, asignada para los procesos.

Type: System.UInt64
Behavior: Read

PagedMemorySize

Cantidad de memoria paginada, en bytes, asignada para los procesos.

Type: System.UInt64
Behavior: Read

ProcessCount

Número de instancias de los procesos especificados que se están ejecutando actualmente.

Type: System.SInt32
Behavior: Read

ProcessId

Identificador único de los procesos.

Type: System.SInt32
Behavior: Read

VirtualMemorySize

Cantidad de memoria virtual, en bytes, asignada para los procesos.

Type: System.UInt64
Behavior: Read

Compartir a través de