Risorsa ProcessSet DSCDSC ProcessSet Resource

Si applica a: Windows PowerShell 5.xApplies To: Windows PowerShell 5.x

La risorsa ProcessSet in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per configurare i processi in un nodo di destinazione.The ProcessSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to configure processes on a target node.

Nota

La documentazione di questa risorsa DSC riguarda la versione inclusa in PowerShell.This documentation of this DSC resource covers the version that is included with PowerShell. Il modulo PSDscResources contiene elementi nuovi e aggiornati ufficialmente supportati da Microsoft.The PSDscResources module contains new and updated that are officially supported by Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.The PSDscResources module is available from the PowerShell Gallery.

Per altre informazioni e per la documentazione aggiornata, vedere il file LEGGIMI nel repository GitHub.For more information and updated documentation, see the README in the GitHub repository.

SintassiSyntax

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

ProprietàProperties

ProprietàProperty DescrizioneDescription
PathPath Percorso dell'eseguibile del processo.The path to the process executable. Se questi sono i nomi dei file eseguibili (non i percorsi completi), la risorsa DSC cercherà i file nella variabile $env:Path di ambiente.If these are the names of the executable files (not fully qualified paths), the DSC resource will search the environment $env:Path variable to find the files. Se i valori di questa proprietà sono percorsi completi, DSC non userà la variabile $env:Path di ambiente per individuare i file e genererà un errore in presenza di percorsi non esistenti.If the values of this property are fully qualified paths, DSC will not use the $env:Path environment variable to find the files, and will throw an error if any of the paths do not exist. I percorsi relativi non sono consentiti.Relative paths are not allowed.
CredenzialeCredential Indica le credenziali per l'avvio del processo.Indicates the credentials for starting the process.
StandardErrorPathStandardErrorPath Percorso in cui i processi scrivono l'errore standard.The path to which the processes write standard error. Qualsiasi file esistente verrà sovrascritto.Any existing file there will be overwritten.
StandardInputPathStandardInputPath Flusso da cui il processo riceve l'input standard.The stream from which the process receives standard input.
StandardOutputPathStandardOutputPath Percorso del file in cui i processi scrivono l'output standard.The path of the file to which the processes write standard output. Qualsiasi file esistente verrà sovrascritto.Any existing file there will be overwritten.
WorkingDirectoryWorkingDirectory Percorso usato come directory di lavoro corrente per i processi.The location used as the current working directory for the processes.

Proprietà comuniCommon properties

ProprietàProperty DescrizioneDescription
DependsOnDependsOn Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa.Indicates that the configuration of another resource must run before this resource is configured. 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".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
EnsureEnsure Specifica se il processo esiste.Specifies whether the processes exists. Impostare questa proprietà su Present per specificare che il processo esiste.Set this property to Present to ensure that the process exists. In caso contrario, impostarla su Absent .Otherwise, set it to Absent . Il valore predefinito è Present .The default value is Present .
PsDscRunAsCredentialPsDscRunAsCredential Imposta le credenziali per l'esecuzione dell'intera risorsa.Sets the credential for running the entire resource as.

Nota

La proprietà comune PsDscRunAsCredential è stata aggiunta in WMF 5.0 per consentire l'esecuzione di qualsiasi risorsa DSC nel contesto di altre credenziali.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. Per altre informazioni, vedere Usare credenziali con risorse DSC.For more information, see Use Credentials with DSC Resources.