Condividi tramite

Invoke-DscResource

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Esegue un metodo di una risorsa DSC specificata.

Sintassi

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

Descrizione

Il Invoke-DscResource cmdlet esegue un metodo di una risorsa Windows PowerShell Desired State Configuration (DSC) specificata. Prima di eseguire questo cmdlet, impostare la modalità di aggiornamento di Local Configuration Manager (LCM) su Disabled.

Questo cmdlet richiama direttamente una risorsa DSC senza creare un documento di configurazione. Usando questo cmdlet, i prodotti di gestione della configurazione possono gestire le finestre usando le risorse DSC. Questo cmdlet abilita anche il debug delle risorse quando il motore DSC o Gestione configurazione locale è in esecuzione con il debug abilitato.

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

Invoke-DscResource -Name Log -Method Set -Property @{Message = 'Hello World'} -ModuleName PSDesiredStateConfiguration

Questo comando richiama il metodo Set di una risorsa denominata Log e specifica una proprietà Message .

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

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

Questo comando richiama il metodo Test di una risorsa denominata WindowsProcess, che si trova nel modulo denominato PSDesiredStateConfiguration.

Parametri

-Method

Specifica il metodo della risorsa richiamata da questo cmdlet. I valori validi per questo parametro sono:

  • Get
  • Set
  • Test
Type:String
Accepted values:Get, Set, Test
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ModuleName

Specifica il nome del modulo da cui questo cmdlet richiama la risorsa specificata.

Type:ModuleSpecification
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica il nome della risorsa DSC da avviare.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Property

Specifica il nome della proprietà delle risorse e il relativo valore in una tabella hash rispettivamente come chiave e valore. Usare il Get-DscResource cmdlet per individuare le proprietà delle risorse e i relativi tipi.

Type:Hashtable
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Output

Microsoft.Management.Infrastructure.CimInstance, System.Boolean