WindowsProcess
Sinopse
Inicie ou interrompa um processo do Windows.
Sintaxe
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 que você verifique se um processo está em execução.
Requisitos
Nenhum.
Propriedades da chave
Argumentos
Especifique a lista completa de argumentos a serem passados para o processo ao iniciá-lo como uma cadeia de caracteres. Defina essa propriedade como uma cadeia de caracteres vazia (''
) se o processo não exigir argumentos.
Type: System.String
Caminho
Especifique o caminho para o arquivo executável do processo. Se o arquivo estiver acessível por meio da PATH
variável de ambiente, você poderá definir essa propriedade como o nome do arquivo executável. Caso contrário, defina essa propriedade como o caminho completo para o arquivo. Não há suporte para caminhos relativos.
Type: System.String
Propriedades opcionais
Credencial
Especifique a credencial da conta para executar o processo.
Se essa propriedade for 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 o processo deve estar em execução. Defina essa propriedade para Present
iniciar o processo se ele não estiver em execução. Defina essa propriedade para Absent
interromper o processo se ele estiver 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 no qual o processo será gravado no fluxo 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 o processo seja lido como seu 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 como 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 o qual o processo deve gravar seu fluxo 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 como 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 do processo. Não há suporte para caminhos relativos.
Não defina essa propriedade ao definir a propriedade Ensure ou a Absent
propriedade Credential como 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 pelo processo.
Type: System.Int32
Behavior: Read
NonPagedMemorySize
A quantidade de memória não paga, em bytes, alocada para o processo.
Type: System.UInt64
Behavior: Read
PagedMemorySize
A quantidade de memória paged, em bytes, alocada para o processo.
Type: System.UInt64
Behavior: Read
ProcessCount
O número de instâncias do determinado processo em execução.
Type: System.Int32
Behavior: Read
ProcessId
O identificador exclusivo do processo.
Type: System.Int32
Behavior: Read
VirtualMemorySize
A quantidade de memória virtual, em bytes, alocada para o processo.
Type: System.UInt64
Behavior: Read
Exemplos
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de