WindowsProcess

Artículo
05/05/2023

Sinopsis

Inicie o detenga un proceso de Windows.

Sintaxis

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]]
}

Descripción

El WindowsProcess recurso le permite asegurarse de si se está ejecutando un proceso.

Requisitos

Ninguno.

Propiedades de la clave

Argumentos

Especifique la lista completa de argumentos que se van a pasar al proceso al iniciarlo como una cadena. Establezca esta propiedad en una cadena vacía ('') si el proceso no requiere ningún argumento.

Type: System.String

Ruta de acceso

Especifique la ruta de acceso al archivo ejecutable del proceso. Si el archivo es accesible a través de la PATH variable de entorno, puede establecer esta propiedad en el nombre del archivo ejecutable. De lo contrario, establezca esta propiedad en la ruta de acceso completa al archivo. No se admiten rutas de acceso relativas.

Type: System.String

Propiedades opcionales

Credential:

Especifique la credencial de la cuenta en la que ejecutar el proceso.

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 el proceso debe estar en ejecución. Establezca esta propiedad Present en para iniciar el proceso si no se está ejecutando. Establezca esta propiedad Absent en para detener el proceso si se está 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 el proceso escriba su flujo de error estándar en . 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 el proceso lea 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 para que el proceso escriba su flujo de salida estándar en . 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 del proceso. No se admiten rutas de acceso relativas.

Type: System.String
Default Value: None

Propiedades de solo lectura

HandleCount

Número de identificadores abiertos por el proceso.

Type: System.Int32
Behavior: Read

NonPagedMemorySize

Cantidad de memoria no paginada, en bytes, asignada para el proceso.

Type: System.UInt64
Behavior: Read

PagedMemorySize

Cantidad de memoria paginada, en bytes, asignada para el proceso.

Type: System.UInt64
Behavior: Read

ProcessCount

Número de instancias del proceso especificado que se están ejecutando.

Type: System.Int32
Behavior: Read

ProcessId

Identificador único del proceso.

Type: System.Int32
Behavior: Read

VirtualMemorySize

Cantidad de memoria virtual, en bytes, asignada para el proceso.

Type: System.UInt64
Behavior: Read