Condividi tramite

Invoke-DscResource

  • Riferimento
Modulo:
PSDesiredStateConfiguration

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

Sintassi

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

Descrizione

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

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 risorse DSC.

Questo cmdlet non funziona con le risorse composte. Le risorse composte sono configurazioni con parametri. L'uso di risorse composte richiede LCM.

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 di 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.

Tipo:String
Valori accettati:Get, Set, Test
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ModuleName

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

Tipo:ModuleSpecification
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome della risorsa DSC da richiamare.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Property

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

Tipo:Hashtable
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Output

Note

  • In Windows PowerShell 5.1 le risorse sono state eseguite nel contesto di sistema, a meno che non sia specificato con il contesto utente usando la chiave PsDscRunAsCredential. In PowerShell 7.0 le risorse vengono eseguite nel contesto dell'utente e PsDscRunAsCredential non sono più supportate. L'uso di questa chiave causa la generazione di un'eccezione del cmdlet.

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