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