Risorsa WindowsProcess DSC

Si applica a: Windows PowerShell 4.0, Windows PowerShell 5.x

La risorsa WindowsProcess in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per configurare i processi in un nodo di destinazione.

Nota

Questa documentazione di questa risorsa DSC illustra la versione inclusa in PowerShell prima della versione 7.2. Il modulo PSDscResources contiene risorse DSC nuove e aggiornate supportate ufficialmente da Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.

Per altre informazioni e documentazione aggiornata, vedere la documentazione di riferimento psDscResources.

Sintassi

WindowsProcess [string] #ResourceName
{
    Arguments = [string]
    Path = [string]
    [ Credential = [PSCredential] ]
    [ StandardErrorPath = [string] ]
    [ StandardInputPath = [string] ]
    [ StandardOutputPath = [string] ]
    [ WorkingDirectory = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Proprietà

Proprietà	Descrizione
Argomenti	Indica una stringa di argomenti da passare al processo come è. Se è necessario passare più argomenti, inserirli tutti in questa stringa.
Percorso	Percorso dell'eseguibile del processo. Se è il nome del file eseguibile (non il percorso completo), la risorsa DSC cercherà il file eseguibile nella variabile $env:Path di ambiente. Se il valore di questa proprietà è un percorso completo, DSC non userà la variabile $env:Path per individuare il file e genererà un errore se il percorso non esiste. I percorsi relativi non sono consentiti.
Credenziale	Indica le credenziali per l'avvio del processo.
StandardErrorPath	Indica il percorso della directory in cui scrivere l'errore standard. Qualsiasi file esistente verrà sovrascritto.
StandardInputPath	Indica il percorso di input standard.
StandardOutputPath	Indica il percorso in cui scrivere l'output standard. Qualsiasi file esistente verrà sovrascritto.
WorkingDirectory	Indica il percorso che verrà usato come directory di lavoro corrente per il processo.

Proprietà comuni

Proprietà	Descrizione
DependsOn	Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa. Ad esempio, se il valore di ID del blocco script di configurazione della risorsa che si vuole eseguire per primo è ResourceName e il tipo è ResourceType, la sintassi per usare questa proprietà è DependsOn = "[ResourceType]ResourceName".
Ensure	Indica se il processo esiste. Impostare questa proprietà su Present per assicurarsi che il processo esista. In caso contrario, impostarlo su Assente. Il valore predefinito è Present.
PsDscRunAsCredential	Imposta le credenziali per l'esecuzione dell'intera risorsa.