Megosztás a következőn keresztül:

Invoke-DscResource

  • Referencia
Modul:
PSDesiredStateConfiguration

Egy megadott PowerShell-Desired State Configuration -erőforrás (DSC) metódusát futtatja.

Syntax

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

Description

A Invoke-DscResource parancsmag egy megadott PowerShell-Desired State Configuration -erőforrás (DSC) metódusát futtatja.

Ez a parancsmag közvetlenül meghív egy DSC-erőforrást konfigurációs dokumentum létrehozása nélkül. Ezzel a parancsmaggal a konfigurációkezelési termékek DSC-erőforrásokkal kezelhetik a Windowst vagy a Linuxot.

Ez a parancsmag nem működik összetett erőforrásokkal. Az összetett erőforrások paraméteres konfigurációk. Az összetett erőforrások használatához az LCM szükséges.

Megjegyzés

A PSDesiredStateConfiguration 2.0.6 előtt a PowerShell 7 használatához Invoke-DscResource engedélyezni kell egy Kísérleti PowerShell-funkciót. Ha a parancsmagot a 2.0.0-2.0.5-ös verzióban szeretné használni, engedélyeznie kell az alábbi paranccsal.

Enable-ExperimentalFeature PSDesiredStateConfiguration.InvokeDscResource

Példák

1. példa: Egy erőforrás Set metódusának meghívása kötelező tulajdonságainak megadásával

Ez a példa meghívja a WindowsProcess nevű erőforrás Set metódusát, és megadja a kötelező Elérési út és argumentumok tulajdonságokat a megadott Windows-folyamat elindításához.

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

2. példa: Erőforrás tesztmetódusának meghívása egy adott modulhoz

Ez a példa meghívja egy WindowsProcess nevű erőforrás Teszt metódusát, amely a PSDesiredStateConfiguration nevű modulban található.

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

Invoke-DscResource @SplatParam

Paraméterek

-Method

Megadja annak az erőforrásnak a metódusát, amelyet a parancsmag meghív. A paraméter elfogadható értékei a következők: Get, Set és Test.

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

-ModuleName

Megadja annak a modulnak a nevét, amely a megadott meghívandó DSC-erőforrást biztosítja.

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

-Name

Megadja a meghívandó DSC-erőforrás nevét.

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

-Property

Az erőforrástulajdonság nevét és értékét adja meg kulcsként és értékként egy kivonattáblában.

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

Bevitelek

String

ModuleSpecification

Kimenetek

Object

Jegyzetek

  • A Windows PowerShell 5.1-ben az erőforrások a Rendszerkörnyezet alatt futottak, kivéve, ha a psDscRunAsCredential kulcs használatával meg nem adva a felhasználói környezettel. A PowerShell 7.0-ban az erőforrások a felhasználó környezetében futnak, és a PsDscRunAsCredential már nem támogatott. A kulcs használata miatt a parancsmag kivételt jelez.

  • A PowerShell 7-ről Invoke-DscResource már nem támogatja a WMI DSC-erőforrások meghívását. Ide tartoznak a PSDesiredStateConfigurationfájl- és naplóerőforrásai.