Partilhar via


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

Exemplos