Recurso ProcessSet de DSCDSC ProcessSet Resource

Se aplica a: Windows PowerShell 5.xApplies To: Windows PowerShell 5.x

El recurso ProcessSet de la configuración de estado deseado (DSC) de Windows PowerShell ofrece un mecanismo para configurar procesos en un nodo de destino.The ProcessSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to configure processes on a target node.

Nota

Esta documentación de este recurso de DSC abarca la versión que se incluye con PowerShell.This documentation of this DSC resource covers the version that is included with PowerShell. El módulo PSDscResources contiene recursos nuevos y actualizados que Microsoft admite oficialmente.The PSDscResources module contains new and updated that are officially supported by Microsoft. El módulo PSDscResources está disponible en la Galería de PowerShell.The PSDscResources module is available from the PowerShell Gallery.

Para obtener más información y documentación actualizada, consulte el archivo Léame en el repositorio de GitHub.For more information and updated documentation, see the README in the GitHub repository.

SintaxisSyntax

ProcessSet [string] #ResourceName
{
    Path = [string]
    [ Credential = [PSCredential] ]
    [ StandardOutputPath = [string] ]
    [ StandardErrorPath = [string] ]
    [ StandardInputPath = [string] ]
    [ WorkingDirectory = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

PropiedadesProperties

PropiedadProperty DescripciónDescription
PathPath La ruta de acceso al ejecutable del proceso.The path to the process executable. Si estos son los nombres de archivo de los ejecutables (no las rutas de acceso completas), el recurso de DSC buscará la variable $env:Path del entorno para buscar los archivos.If these are the names of the executable files (not fully qualified paths), the DSC resource will search the environment $env:Path variable to find the files. Si los valores de esta propiedad son rutas completas, DSC no usará la variable de entorno $env:Path para buscar los archivos y generará un error si alguna de las rutas de acceso no existe.If the values of this property are fully qualified paths, DSC will not use the $env:Path environment variable to find the files, and will throw an error if any of the paths do not exist. No se permiten rutas de acceso relativas.Relative paths are not allowed.
Credential:Credential Indica las credenciales para iniciar el proceso.Indicates the credentials for starting the process.
StandardErrorPathStandardErrorPath La ruta de acceso en la que los procesos escriben los errores estándar.The path to which the processes write standard error. Se sobrescribirá cualquier archivo existente en la ubicación.Any existing file there will be overwritten.
StandardInputPathStandardInputPath La secuencia desde la que el proceso recibe las entradas estándar.The stream from which the process receives standard input.
StandardOutputPathStandardOutputPath La ruta de acceso del archivo en la que los procesos escriben las salidas estándar.The path of the file to which the processes write standard output. Se sobrescribirá cualquier archivo existente en la ubicación.Any existing file there will be overwritten.
WorkingDirectoryWorkingDirectory La ubicación utilizada como directorio de trabajo actual de los procesos.The location used as the current working directory for the processes.

Propiedades comunesCommon properties

PropiedadProperty DescripciónDescription
DependsOnDependsOn Indica que la configuración de otro recurso debe ejecutarse antes de que se configure este recurso.Indicates that the configuration of another resource must run before this resource is configured. Por ejemplo, si el elemento ID del bloque del script de configuración del recurso que quiere ejecutar primero es ResourceName y su tipo es ResourceType, la sintaxis para usar esta propiedad es DependsOn = "[ResourceType]ResourceName".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
EnsureEnsure Especifica si los procesos existen.Specifies whether the processes exists. Establezca esta propiedad en Present para asegurarse de que el proceso exista.Set this property to Present to ensure that the process exists. De lo contrario, establézcala en Absent .Otherwise, set it to Absent . El valor predeterminado es Present .The default value is Present .
PsDscRunAsCredentialPsDscRunAsCredential Establece la credencial con la que se ejecutará todo el recurso.Sets the credential for running the entire resource as.

Nota

Se ha agregado la propiedad común PsDscRunAsCredential en WMF 5.0 para permitir la ejecución de cualquier recurso de DSC en el contexto de otras credenciales.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. Para obtener más información, vea Uso de las credenciales con recursos de DSC.For more information, see Use Credentials with DSC Resources.