Recurso ProcessSet da DSC
Aplica-se a: Windows PowerShell 5.x
O recurso ProcessSet na DSC (Configuração de Estado Desejado) do Windows PowerShell fornece um mecanismo para configurar processos em um nó de destino.
Observação
Esta documentação desse recurso DSC aborda 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 com suporte oficial da Microsoft. O módulo PSDscResources está disponível na Galeria do PowerShell.
Para obter mais informações e documentação atualizada, consulte a documentação de referência PSDscResources.
Sintaxe
ProcessSet [string] #ResourceName
{
Path = [string]
[ Credential = [PSCredential] ]
[ StandardOutputPath = [string] ]
[ StandardErrorPath = [string] ]
[ StandardInputPath = [string] ]
[ WorkingDirectory = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Propriedades
Propriedade | Descrição |
---|---|
Caminho | O caminho para o executável do processo. Se esses forem os nomes dos arquivos executáveis (caminhos não totalmente qualificados), o recurso DSC pesquisará a variável de ambiente $env:Path para localizar os arquivos. Se os valores dessa propriedade forem caminhos totalmente qualificados, o DSC não usará a variável de ambiente $env:Path para localizar os arquivos e gerará um erro se qualquer um dos caminhos não existir. Caminhos relativos não são permitidos. |
Credencial | Indica as credenciais para iniciar o processo. |
StandardErrorPath | O caminho para o qual os processos gravam o erro padrão. Qualquer arquivo existente será substituído. |
StandardInputPath | O fluxo do qual o processo recebe entrada padrão. |
StandardOutputPath | O caminho do arquivo para o qual os processos gravam a saída padrão. Qualquer arquivo existente será substituído. |
WorkingDirectory | O local usado como diretório de trabalho atual para os processos. |
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 | Especifica se os processos existem. 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. |
Observação
A propriedade comum PsDscRunAsCredential foi adicionada ao WMF 5.0 para permitir a execução de qualquer recurso de DSC no contexto de outras credenciais. Para saber mais, confira Usar credenciais com recursos de DSC.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de