ProcessSet

Artigo
05/05/2023

Sinopse

Gerenciar vários processos do Windows com configurações comuns.

Sintaxe

ProcessSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Path = [String[]]
    [Ensure = [String]]
    [Credential = [PSCredential]]
    [StandardOutputPath = [String]]
    [StandardErrorPath = [String]]
    [StandardInputPath = [String]]
    [WorkingDirectory = [String]]
}

Descrição

O ProcessSet recurso composto permite que você configure vários processos do Windows com um conjunto limitado de opções comuns. Para gerenciar processos com mais controle, incluindo a capacidade de passar argumentos para o processo, use o recurso do WindowsProcess.

Requisitos

Nenhum.

Propriedades da chave

Caminho

Especifique os caminhos para os arquivos executáveis dos processos. Se um arquivo estiver acessível por meio da PATH variável de ambiente, você poderá especificar o nome do arquivo. Caso contrário, especifique o caminho completo para o arquivo. Não há suporte para caminhos relativos.

Type: System.String[]
Behavior: Key

Propriedades opcionais

Credencial

Especifique a credencial da conta na qual executar os processos.

Se essa propriedade estiver definida como uma conta do sistema local, você não poderá definir as propriedades StandardOutputPath, StandardInputPath ou WorkingDirectory . Se você fizer isso, o recurso gerará uma exceção de argumento inválida.

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Especifique se os processos devem estar em execução. Defina essa propriedade para Present iniciar os processos se eles não estiverem em execução. Defina essa propriedade para Absent interromper os processos se eles estiverem em execução.

O valor padrão é Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

StandardErrorPath

Especifique o caminho completo para um arquivo para que os processos escrevam seus fluxos de erro padrão. Não há suporte para caminhos relativos. Se o arquivo existir, ele será substituído.

Não defina essa propriedade ao definir a propriedade Ensure como Absent. Se você fizer isso, o recurso gerará uma exceção de argumento inválida.

Type: System.String
Default Value: None

StandardInputPath

Especifique o caminho completo para um arquivo para que os processos sejam lidos como fluxo de entrada padrão. Não há suporte para caminhos relativos.

Não defina essa propriedade ao definir a propriedade Ensure ou a Absent propriedade Credential para uma conta do sistema local. Se você fizer isso, o recurso gerará uma exceção de argumento inválida.

Type: System.String
Default Value: None

StandardOutputPath

Especifique o caminho completo para um arquivo para que os processos escrevam seus fluxos de saída padrão. Não há suporte para caminhos relativos. Se o arquivo existir, ele será substituído.

Type: System.String
Default Value: None

WorkingDirectory

Especifique o caminho completo para uma pasta para o diretório de trabalho dos processos. Não há suporte para caminhos relativos.

Type: System.String
Default Value: None

Propriedades somente leitura

HandleCount

O número de identificadores abertos pelos processos.

Type: System.SInt32
Behavior: Read

NonPagedMemorySize

A quantidade de memória não paga, em bytes, alocada para os processos.

Type: System.UInt64
Behavior: Read

PagedMemorySize

A quantidade de memória paged, em bytes, alocada para os processos.

Type: System.UInt64
Behavior: Read

ProcessCount

O número de instâncias dos processos determinados que estão em execução no momento.

Type: System.SInt32
Behavior: Read

ProcessId

O identificador exclusivo dos processos.

Type: System.SInt32
Behavior: Read

VirtualMemorySize

A quantidade de memória virtual, em bytes, alocada para os processos.

Type: System.UInt64
Behavior: Read

Share via