Aracılığıyla paylaş

Invoke-DscResource

  • Başvuru
Modül:
PSDesiredStateConfiguration

Belirtilen bir PowerShell Desired State Configuration (DSC) kaynağının yöntemini çalıştırır.

Syntax

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

Description

Cmdlet, Invoke-DscResource belirtilen bir PowerShell Desired State Configuration (DSC) kaynağının yöntemini çalıştırır.

Bu cmdlet, yapılandırma belgesi oluşturmadan doğrudan bir DSC kaynağını çağırır. Yapılandırma yönetimi ürünleri bu cmdlet'i kullanarak Windows veya Linux'ı DSC kaynaklarıyla yönetebilir.

Bu cmdlet bileşik kaynaklarla çalışmaz. Bileşik kaynaklar parametreli yapılandırmalardır. Bileşik kaynakların kullanılması IÇIN LCM gerekir.

Not

PSDesiredStateConfiguration 2.0.6'den önce, PowerShell 7'de kullanmak Invoke-DscResource için PowerShell deneysel özelliğinin etkinleştirilmesi gerekir. Cmdlet'i 2.0.0 ile 2.0.5 arası sürümlerde kullanmak için aşağıdaki komutla etkinleştirmeniz gerekir.

Enable-ExperimentalFeature PSDesiredStateConfiguration.InvokeDscResource

Örnekler

Örnek 1: Zorunlu özelliklerini belirterek kaynağın Set yöntemini çağırma

Bu örnek, WindowsProcess adlı kaynağın Set yöntemini çağırır ve belirtilen Windows işlemini başlatmak için zorunlu Path ve Arguments özelliklerini sağlar.

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

Örnek 2: Belirtilen modül için kaynağın Test yöntemini çağırma

Bu örnek, PSDesiredStateConfiguration adlı modülde yer alan WindowsProcess adlı kaynağın Test yöntemini çağırır.

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

Invoke-DscResource @SplatParam

Parametreler

-Method

Bu cmdlet'in çağırıldığı kaynağın yöntemini belirtir. Bu parametre için kabul edilebilir değerler şunlardır: Get, Set ve Test.

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

-ModuleName

Çağrılacak belirtilen DSC Kaynağını sağlayan modülün adını belirtir.

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

-Name

Çağrılacak DSC kaynağının adını belirtir.

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

-Property

Bir karma tablodaki kaynak özellik adını ve değerini sırasıyla anahtar ve değer olarak belirtir.

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

Girişler

String

ModuleSpecification

Çıkışlar

Object

Notlar

  • Windows PowerShell 5.1 kaynaklarında, PsDscRunAsCredential anahtarı kullanılarak kullanıcı bağlamı ile belirtilmediği sürece Sistem bağlamı altında çalıştırıldı. PowerShell 7.0'da Kaynaklar kullanıcının bağlamında çalışır ve PsDscRunAsCredential artık desteklenmemektedir. Bu anahtarın kullanılması, cmdlet'in bir özel durum oluşturmasına neden olur.

  • PowerShell 7 itibarıyla WMI Invoke-DscResource DSC kaynaklarını çağırmayı artık desteklememektedir. Bu, PSDesiredStateConfiguration içindeki Dosya ve Günlük kaynaklarını içerir.