Recurso WindowsProcess de DSCDSC WindowsProcess Resource

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

O recurso ProcessSet na DSC (Configuração de Estado Desejado) do Windows PowerShell fornece um mecanismo para configurar processos em um nó de destino.The ProcessSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to configure processes on a target node. Esse recurso é um recurso composto que chama o Recurso do WindowsProcess para cada grupo especificado no parâmetro GroupName.This resource is a composite resource that calls the WindowsProcess resource for each group specified in the GroupName parameter.

SintaxeSyntax

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

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
ArgumentosArguments Uma cadeia de caracteres que contém os argumentos a serem passados ao processo no estado em que se encontram.A string that contains 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 Os caminhos para os executáveis do processo.The paths to the process executables. Se esses forem os nomes dos arquivos executáveis (caminhos não totalmente qualificados), o recurso DSC pesquisará a variável de ambiente Path ($env:Path) para localizar os arquivos.If these are the names of the executable files (not fully qualified paths), the DSC resource will search the environment Path variable ($env:Path) to find the files. Se os valores dessa propriedade forem caminhos totalmente qualificados, a DSC não usará a variável de ambiente Path para localizar os arquivos e gerará um erro se qualquer um dos caminhos não existir.If the values of this property are fully qualified paths, DSC will not use the Path environment variable to find the files, and will throw an error if any of the paths do 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 Especifica se os processos existem.Specifies whether the processes 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".
StandardErrorPathStandardErrorPath O caminho para o qual os processos gravam o erro padrão.The path to which the processes write standard error. Qualquer arquivo existente será substituído.Any existing file there will be overwritten.
StandardInputPathStandardInputPath O fluxo do qual o processo recebe entrada padrão.The stream from which the process receives standard input.
StandardOutputPathStandardOutputPath O caminho do arquivo para o qual os processos gravam a saída padrão.The path of the file to which the processes write standard output. Qualquer arquivo existente será substituído.Any existing file there will be overwritten.
WorkingDirectoryWorkingDirectory O local usado como diretório de trabalho atual para os processos.The location used as the current working directory for the processes.
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"` .