Condividi tramite

Invoke-DscResource

Modulo:
PSDesiredStateConfiguration Module

Esegue un metodo di una risorsa DSC (Desired State Configuration) di PowerShell specificata.

Sintassi

Default (impostazione predefinita). 

Invoke-DscResource
    [-Name] <String>
    [[-ModuleName] <ModuleSpecification>]
    [-Method] <String>
    [-Property] <Hashtable>
    [<CommonParameters>]

Descrizione

Il Invoke-DscResource cmdlet esegue un metodo di una risorsa DSC (Desired State Configuration) di PowerShell specificata.

Questo cmdlet richiama direttamente una risorsa DSC senza creare un documento di configurazione. Usando questo cmdlet, i prodotti di gestione della configurazione possono gestire Windows o Linux con le risorse DSC.

Questo cmdlet non funziona con le risorse composite. Le risorse composite sono configurazioni con parametri. L'uso di risorse composite richiede Gestione configurazione locale.

Esempio

Esempio 1: Richiamare il metodo Set di una risorsa specificando le relative proprietà obbligatorie

In questo esempio viene richiamato il metodo Set di una risorsa denominata WindowsProcess e vengono fornite le proprietà Path e Arguments obbligatorie per avviare il processo Windows specificato.

Invoke-DscResource -Name WindowsProcess -Method Set -ModuleName PSDesiredStateConfiguration -Property @{
    Path      = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'
    Arguments = ''
}

Esempio 2: Richiamare il metodo Test di una risorsa per un modulo specificato

In questo esempio viene richiamato il metodo Test di una risorsa denominata WindowsProcess, che si trova nel modulo denominato PSDesiredStateConfiguration.

$SplatParam = @{
    Name       = 'WindowsProcess'
    ModuleName = 'PSDesiredStateConfiguration'
    Method     = 'Test'
    Property   = @{
        Path      = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'
        Arguments = ''
    }
}

Invoke-DscResource @SplatParam

Parametri

-Method

Specifica il metodo della risorsa richiamata da questo cmdlet. I valori accettabili per questo parametro sono: Get, Set e Test.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Get, Set, Test
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ModuleName

Specifica il nome del modulo che fornisce la risorsa DSC specificata da richiamare.

Proprietà dei parametri

Tipo:ModuleSpecification
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome della risorsa DSC da richiamare.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Property

Specifica il nome della proprietà della risorsa e il relativo valore in una tabella hash rispettivamente come chiave e valore.

Proprietà dei parametri

Tipo:Hashtable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

ModuleSpecification

Output

Object

Note

  • In Windows PowerShell 5.1 le risorse venivano eseguite nel contesto di sistema, a meno che non fosse specificato con il contesto utente usando la chiave PsDscRunAsCredential. In PowerShell 7.0 le risorse vengono eseguite nel contesto dell'utente e PsDscRunAsCredential non è più supportato. L'uso di questa chiave fa sì che il cmdlet generi un'eccezione.

  • A partire da PowerShell 7, Invoke-DscResource non supporta più la chiamata delle risorse WMI DSC. Sono incluse le risorse File e Log in PSDesiredStateConfiguration.