Share via

Invoke-DscResource

  • Başvuru
Modül:
PSDesiredStateConfiguration

Belirtilen DSC kaynağının yöntemini çalıştırır.

Syntax

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

Description

Cmdlet, Invoke-DscResource belirtilen bir Windows PowerShell Desired State Configuration (DSC) kaynağının yöntemini çalıştırır. Bu cmdlet'i çalıştırmadan önce Yerel Configuration Manager (LCM) yenileme modunu Devre Dışı olarak ayarlayın.

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 DSC kaynaklarını kullanarak pencereleri yönetebilir. Bu cmdlet ayrıca DSC altyapısı veya LCM, hata ayıklama etkinken kaynakların hata ayıklamasını da etkinleştirir.

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

Örnekler

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

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

Bu komut Log adlı kaynağın Set yöntemini çağırır ve bunun için bir Message özelliği belirtir.

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

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

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

Parametreler

-Method

Bu cmdlet'in çağırıldığı kaynağın yöntemini belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • 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

Bu cmdlet'in belirtilen kaynağı çağırdığı modülün adını belirtir.

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

-Name

Başlatacak 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 özelliği adını ve değerini sırasıyla anahtar ve değer olarak belirtir. Get-DscResource Kaynak özelliklerini ve türlerini bulmak için cmdlet'ini kullanın.

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

Çıkışlar

Microsoft.Management.Infrastructure.CimInstance, System.Boolean