WindowsProcess
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.
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
WorkingDirectory
Especifique la ruta de acceso completa a una carpeta para el directorio de trabajo del proceso. 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
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
