WindowsProcess
Sinopse
Iniciar ou parar um processo do Windows.
Syntax
WindowsProcess [String] #ResourceName
{
Arguments = [string]
Path = [string]
[Credential = [PSCredential]]
[DependsOn = [string[]]]
[Ensure = [string]{ Absent | Present }]
[PsDscRunAsCredential = [PSCredential]]
[StandardErrorPath = [string]]
[StandardInputPath = [string]]
[StandardOutputPath = [string]]
[WorkingDirectory = [string]]
}
Descrição
O WindowsProcess
recurso permite-lhe garantir se um processo está em curso.
Requisitos
Nenhum.
Propriedades principais
Argumentos
Especifique a lista completa de argumentos para passar ao processo ao iniciá-lo como uma cadeia. Desa esta propriedade a uma corda vazia (''
) se o processo não necessitar de argumentos.
Type: System.String
Caminho
Especifique o caminho para o ficheiro executável do processo. Se o ficheiro estiver acessível através da variável ambiente PATH
, poderá definir esta propriedade para o nome do ficheiro executável. Caso contrário, desacordo esta propriedade em todo o caminho para o arquivo. Caminhos relativos não são suportados.
Type: System.String
Propriedades opcionais
Credencial
Especifique a credencial da conta para executar o processo em.
Se esta propriedade estiver definida para uma conta do sistema local, não é possível definir as propriedades StandardOutputPath, StandardInputPath ou WorkingDirectory . Se o fizer, o recurso lança uma exceção de argumento inválido.
Type: System.Management.Automation.PSCredential
Default Value: None
Garantir
Especificar se o processo deve estar em execução. Desacordo esta propriedade para Present
iniciar o processo se não estiver em funcionamento. Desemcora esta propriedade para Absent
parar o processo se estiver em funcionamento.
O valor predefinido é Present
.
Type: System.String
Accepted Values:
- Absent
- Present
Default Value: Present
StandardErrorPath
Especifique o caminho completo para um ficheiro para que o processo escreva o seu fluxo de erro padrão para. Caminhos relativos não são suportados. Se o ficheiro existe, está escrito.
Não defina este imóvel ao definir o imóvel 'Garantir'.Absent
Se o fizer, o recurso lança uma exceção de argumento inválido.
Type: System.String
Default Value: None
StandardInputPath
Especifique o caminho completo para um ficheiro para que o processo leia como o seu fluxo de entrada padrão. Caminhos relativos não são suportados.
Não defina este imóvel ao definir a propriedade 'Garantir ' ou a Absent
propriedade Credencial para uma conta do sistema local. Se o fizer, o recurso lança uma exceção de argumento inválido.
Type: System.String
Default Value: None
StandardOutputPath
Especifique o caminho completo para um ficheiro para que o processo escreva o seu fluxo de saída padrão para. Caminhos relativos não são suportados. Se o ficheiro existe, está escrito.
Não defina este imóvel ao definir a propriedade 'Garantir ' ou a Absent
propriedade Credencial para uma conta do sistema local. Se o fizer, o recurso lança uma exceção de argumento inválido.
Type: System.String
Default Value: None
WorkingDirectory
Especifique o caminho completo para uma pasta para o diretório de trabalho do processo. Caminhos relativos não são suportados.
Não defina este imóvel ao definir a propriedade 'Garantir ' ou a Absent
propriedade Credencial para uma conta do sistema local. Se o fizer, o recurso lança uma exceção de argumento inválido.
Type: System.String
Default Value: None
Propriedades só de leitura
HandleCount
O número de pegas abertas pelo processo.
Type: System.Int32
Behavior: Read
NonPagedMemorySize
A quantidade de memória não pageed, em bytes, atribuída para o processo.
Type: System.UInt64
Behavior: Read
Tamanho do PagedMemorySize
A quantidade de memória paged, em bytes, atribuída para o processo.
Type: System.UInt64
Behavior: Read
Conta de Processos
O número de ocorrências do processo que está em curso.
Type: System.Int32
Behavior: Read
ProcessId
O identificador único do processo.
Type: System.Int32
Behavior: Read
Tamanho virtual
A quantidade de memória virtual, em bytes, atribuída para o processo.
Type: System.UInt64
Behavior: Read