ProcessSet
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.
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
WorkingDirectory
Especifique o caminho completo para uma pasta para o diretório de trabalho dos processos. 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
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
