Recurso WindowsProcess de DSCDSC WindowsProcess Resource

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

O recurso WindowsProcess na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para configurar processos em um nó de destino.The WindowsProcess resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to configure processes on a target node.

SintaxeSyntax

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

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
ArgumentosArguments Indica uma cadeia de caracteres de argumentos para passar para o processo no estado em que se encontra.Indicates a string of arguments to pass to the process as-is. Se você precisar passar vários argumentos, coloque todos nessa cadeia de caracteres.If you need to pass several arguments, put them all in this string.
CaminhoPath O caminho para o executável do processo.The path to the process executable. Se esse for o nome do arquivo do executável (não o caminho totalmente qualificado), o recurso DSC pesquisará a variável de ambiente caminho ($env:Path) para localizar o arquivo executável.If this the file name of the executable (not the fully qualified path), the DSC resource will search the environment Path variable ($env:Path) to find the executable file. Se o valor dessa propriedade for um caminho totalmente qualificado, o DSC não usará a variável de ambiente Caminho para encontrar o arquivo e emitirá um erro se o caminho não existir.If the value of this property is a fully qualified path, DSC will not use the Path environment variable to find the file, and will throw an error if the path does not exist. Caminhos relativos não são permitidos.Relative paths are not allowed.
CredentialCredential Indica as credenciais para iniciar o processo.Indicates the credentials for starting the process.
EnsureEnsure Indica se o processo existe.Indicates if the process exists. Defina essa propriedade como "Present" para garantir que o processo exista.Set this property to "Present" to ensure that the process exists. Caso contrário, defina-a como "Absent".Otherwise, set it to "Absent". O padrão é "Present".The default is "Present".
DependsOnDependsOn Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado.Indicates that the configuration of another resource must run before this resource is configured. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será 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"` .
StandardErrorPathStandardErrorPath Indica o caminho do diretório para escrever o erro padrão.Indicates the directory path to write the standard error. Qualquer arquivo existente será substituído.Any existing file there will be overwritten.
StandardInputPathStandardInputPath Indica o local de entrada padrão.Indicates the standard input location.
StandardOutputPathStandardOutputPath Indica o local para escrever a saída padrão.Indicates the location to write the standard output. Qualquer arquivo existente será substituído.Any existing file there will be overwritten.
WorkingDirectoryWorkingDirectory Indica o local que será usado como diretório de trabalho atual para o processo.Indicates the location that will be used as the current working directory for the process.