WindowsProcess

Artikel
05/05/2023

Synopsis

Starta eller stoppa en Windows-process.

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

Med resursen WindowsProcess kan du kontrollera om en process körs.

Krav

Inga.

Nyckelegenskaper

Argument

Ange den fullständiga listan med argument som ska skickas till processen när du startar den som en sträng. Ställ in den här egenskapen på en tom sträng ('') om processen inte kräver några argument.

Type: System.String

Sökväg

Ange sökvägen till processens körbara fil. Om filen är tillgänglig via PATH miljövariabeln kan du ange den här egenskapen till den körbara filens namn. Annars anger du den här egenskapen till den fullständiga sökvägen till filen. Relativa sökvägar stöds inte.

Type: System.String

Valfria egenskaper

Autentiseringsuppgift

Ange autentiseringsuppgifterna för det konto som processen ska köras under.

Om den här egenskapen är inställd på ett lokalt systemkonto kan du inte ange egenskaperna StandardOutputPath, StandardInputPath eller WorkingDirectory . Om du gör det genererar resursen ett ogiltigt argumentfel.

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

Säkerställa

Ange om processen ska köras. Ställ in den här egenskapen på Present för att starta processen om den inte körs. Ställ in den här egenskapen på Absent för att stoppa processen om den körs.

Standardvärdet är Present.

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

StandardErrorPath

Ange den fullständiga sökvägen till en fil för processen som standardfelströmmen ska skrivas till. Relativa sökvägar stöds inte. Om filen finns skrivs den över.

Ställ inte in den här egenskapen när du anger egenskapen Kontrollera till Absent. Om du gör det genererar resursen ett ogiltigt argumentfel.

Type: System.String
Default Value: None

StandardInputPath

Ange den fullständiga sökvägen till en fil som processen ska läsa som standardindataström. Relativa sökvägar stöds inte.

Ange inte den här egenskapen när du anger egenskapen Kontrollera till Absent eller egenskapen Autentiseringsuppgift till ett lokalt systemkonto. Om du gör det genererar resursen ett ogiltigt argumentfel.

Type: System.String
Default Value: None

StandardOutputPath

Ange den fullständiga sökvägen till en fil som processen ska skriva standardutdataströmmen till. Relativa sökvägar stöds inte. Om filen finns skrivs den över.

Type: System.String
Default Value: None

WorkingDirectory

Ange den fullständiga sökvägen till en mapp för processens arbetskatalog. Relativa sökvägar stöds inte.

Type: System.String
Default Value: None

Skrivskyddade egenskaper

HandleCount

Antalet referenser som öppnats av processen.

Type: System.Int32
Behavior: Read

NonPagedMemorySize

Mängden icke-växlingsbart minne i byte som allokerats för processen.

Type: System.UInt64
Behavior: Read

PagedMemorySize

Mängden växlingsbart minne i byte som allokerats för processen.

Type: System.UInt64
Behavior: Read

ProcessCount

Antalet instanser av den angivna processen som körs.

Type: System.Int32
Behavior: Read

Processid

Den unika identifieraren för processen.

Type: System.Int32
Behavior: Read

VirtualMemorySize

Mängden virtuellt minne i byte som allokerats för processen.

Type: System.UInt64
Behavior: Read

Share via