Invoke-DscResource

Modül:
PSDesiredStateConfiguration Module

Belirtilen bir PowerShell İstenen Durum Yapılandırması (DSC) kaynağının yöntemini çalıştırır.

Syntax

Default (Varsayılan) 

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

Description

Invoke-DscResource cmdlet'i, belirtilen bir PowerShell İstenen Durum Yapılandırması (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 DSC kaynaklarıyla windows veya Linux'ı yönetebilir.

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

Bu örnek, WindowsProcess adlı kaynağın Set yöntemini çağırır ve belirtilen Windows işlemini başlatmak için zorunlu Yol ve Bağımsız Değişkenleri ö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, PSDesiredStateConfigurationadlı modülde yer alan WindowsProcessadlı 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, Setve Test.

Parametre özellikleri

Tür:String
Default value:None
Kabul edilen değerler:Get, Set, Test
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:2
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ModuleName

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

Parametre özellikleri

Tür:ModuleSpecification
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:1
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Property

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

Parametre özellikleri

Tür:Hashtable
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:3
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

ModuleSpecification

Çıkışlar

Object

Notlar

  • Windows PowerShell 5.1'de psdscRunAsCredential anahtarı kullanılarak kullanıcı bağlamı ile belirtilmediği sürece, Windows PowerShell 5.1 kaynakları 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'de Invoke-DscResource artık WMI DSC kaynaklarını çağırmayı desteklememektedir. Bu, PSDesiredStateConfigurationiçindeki Dosya ve Günlük kaynaklarını içerir.