WindowsProcess

  • Článek

Synopse

Spusťte nebo zastavte proces 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]]
}

Description

Prostředek WindowsProcess umožňuje zajistit, jestli je proces spuštěný.

Požadavky

Žádné

Základní vlastnosti

Argumenty

Zadejte úplný seznam argumentů, které se mají předat procesu při jeho spuštění jako řetězec. Tuto vlastnost nastavte na prázdný řetězec (''), pokud proces nevyžaduje žádné argumenty.

Type: System.String

Cesta

Zadejte cestu ke spustitelnému souboru procesu. Pokud je soubor přístupný prostřednictvím PATH proměnné prostředí, můžete tuto vlastnost nastavit na název spustitelného souboru. V opačném případě nastavte tuto vlastnost na úplnou cestu k souboru. Relativní cesty nejsou podporovány.

Type: System.String

Volitelné vlastnosti

Přihlašovací údaj

Zadejte přihlašovací údaje účtu, ve kterém se má proces spustit.

Pokud je tato vlastnost nastavená na místní systémový účet, nemůžete nastavit vlastnosti StandardOutputPath, StandardInputPath nebo WorkingDirectory . Pokud to uděláte, prostředek vyvolá neplatnou výjimku argumentu.

Type: System.Management.Automation.PSCredential
Default Value: None

Zajištění

Určete, jestli má být proces spuštěný. Tuto vlastnost nastavte tak, aby Present se proces spustil, pokud není spuštěný. Tuto vlastnost nastavte tak, aby Absent se proces zastavil, pokud je spuštěný.

Výchozí hodnota je Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

StandardErrorPath

Zadejte úplnou cestu k souboru pro proces zápisu standardního chybového streamu do. Relativní cesty nejsou podporovány. Pokud soubor existuje, přepíše se.

Tuto vlastnost nenastavujte při nastavování vlastnosti Zajistit na Absenthodnotu . Pokud to uděláte, prostředek vyvolá neplatnou výjimku argumentu.

Type: System.String
Default Value: None

StandardInputPath

Zadejte úplnou cestu k souboru pro proces, který se má číst jako standardní vstupní datový proud. Relativní cesty nejsou podporovány.

Tuto vlastnost nenastavujte při nastavování vlastnosti AbsentZajistit na místní systémový účet nebo vlastnost Credential. Pokud to uděláte, prostředek vyvolá neplatnou výjimku argumentu.

Type: System.String
Default Value: None

StandardOutputPath

Zadejte úplnou cestu k souboru pro proces zápisu standardního výstupního streamu do. Relativní cesty nejsou podporovány. Pokud soubor existuje, přepíše se.

Tuto vlastnost nenastavujte při nastavování vlastnosti AbsentZajistit na místní systémový účet nebo vlastnost Credential. Pokud to uděláte, prostředek vyvolá neplatnou výjimku argumentu.

Type: System.String
Default Value: None

WorkingDirectory

Zadejte úplnou cestu ke složce pracovního adresáře procesu. Relativní cesty nejsou podporovány.

Tuto vlastnost nenastavujte při nastavování vlastnosti AbsentZajistit na místní systémový účet nebo vlastnost Credential. Pokud to uděláte, prostředek vyvolá neplatnou výjimku argumentu.

Type: System.String
Default Value: None

Vlastnosti jen pro čtení

HandleCount

Počet popisovačů otevřených procesem

Type: System.Int32
Behavior: Read

NonPagedMemorySize

Množství nestránkové paměti přidělené procesu v bajtech.

Type: System.UInt64
Behavior: Read

PagedMemorySize

Množství stránkované paměti přidělené procesu v bajtech.

Type: System.UInt64
Behavior: Read

ProcessCount

Počet instancí daného procesu, které jsou spuštěné.

Type: System.Int32
Behavior: Read

Processid

Jedinečný identifikátor procesu.

Type: System.Int32
Behavior: Read

VirtualMemorySize

Množství virtuální paměti přidělené procesu v bajtech.

Type: System.UInt64
Behavior: Read

Příklady