Recurso WindowsProcess de DSC

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.x

O recurso WindowsProcess na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para configurar processos em um nó de destino.

Observação

Esta documentação desse recurso de DSC abrange a versão incluída no PowerShell antes da versão 7.2. O módulo PSDscResources contém recursos de DSC novos e atualizados que têm suporte oficial da Microsoft. O módulo PSDscResources está disponível na Galeria do PowerShell.

Para obter mais informações e a documentação atualizada, consulte a documentação de referência do PSDscResources.

Sintaxe

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

Propriedades

Propriedade	Descrição
Argumentos	Indica uma cadeia de caracteres de argumentos para passar para o processo no estado em que se encontra. Se você precisar passar vários argumentos, coloque todos nessa cadeia de caracteres.
Caminho	O caminho para o executável do processo. 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 $env:Path para localizar o arquivo executável. Se o valor dessa propriedade for um caminho totalmente qualificado, o DSC não usará a variável de ambiente $env:Path para localizar o arquivo e emitirá um erro se o caminho não existir. Caminhos relativos não são permitidos.
Credencial	Indica as credenciais para iniciar o processo.
StandardErrorPath	Indica o caminho do diretório para escrever o erro padrão. Qualquer arquivo existente será substituído.
StandardInputPath	Indica o local de entrada padrão.
StandardOutputPath	Indica o local para escrever a saída padrão. Qualquer arquivo existente será substituído.
WorkingDirectory	Indica o local que será usado como diretório de trabalho atual para o processo.

Propriedades comuns

Propriedade	Descrição
DependsOn	Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado. 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".
Ensure	Indica se o processo existe. Defina essa propriedade como Present para garantir que o processo exista. Caso contrário, defina-o como Absent. O valor padrão é Present.
PsDscRunAsCredential	Define a credencial para executar todo o recurso.