Invoke-DscResource
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
Çıkışlar
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.
İlişkili Bağlantılar
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin