Test-DscConfiguration

Modül:

PSDesiredStateConfiguration Module v1.1

Düğümlerde gerçek yapılandırmanın istenen yapılandırmayla eşleşip eşleşmediğini sınar.

Sözdizimi

ComputerNameSet EnterprisePublishing

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

ComputerNameAndPathSet

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Path] <String>
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

ComputerNameAndReferenceConfigurationSet

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    -ReferenceConfiguration <String>
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionAndPathSet

Test-DscConfiguration
    [-Path] <String>
    -CimSession <CimSession[]>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionAndReferenceConfigurationSet

Test-DscConfiguration
    -CimSession <CimSession[]>
    -ReferenceConfiguration <String>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

CimSessionSet

Test-DscConfiguration
    -CimSession <CimSession[]>
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Description

Test-DscConfiguration cmdlet'i düğümlerde gerçek yapılandırmanın istenen yapılandırmayla eşleşip eşleşmediğini test eder. Bilgisayar adlarını veya Ortak Bilgi Modeli (CIM) oturumlarını kullanarak yapılandırmaları test etmek istediğiniz bilgisayarları belirtin. Hedef bilgisayar belirtmezseniz, cmdlet yerel bilgisayarın yapılandırmasını test eder.

İstenen ve gerçek yapılandırmalar eşleşiyorsa, cmdlet 'True' dize değerini döndürür. Aksi takdirde, 'False' dize değerini döndürür.

Örnekler

Örnek 1: Yerel bilgisayar için test yapılandırması

Test-DscConfiguration

Bu komut, yerel bilgisayar için yapılandırmayı sınar.

Örnek 2: Belirtilen bir bilgisayar için yapılandırmasını test edin

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

Bu örnek, CIM oturumu tarafından belirtilen bir bilgisayardan yapılandırmayı test edin. Örnek, cmdlet'iyle kullanmak üzere Server01 adlı bir bilgisayar için bir CIM oturumu oluşturur. Alternatif olarak, cmdlet'i belirtilen birden çok bilgisayara uygulamak için bir CIM oturumları dizisi oluşturun.

İlk komut, New-CimSession cmdlet'ini kullanarak bir CIM oturumu oluşturur ve ardından CimSession nesnesini $Session değişkeninde depolar. Komut sizden bir parola ister. Daha fazla bilgi için Get-Help New-CimSessionyazın.

İkinci komut, değişkeninde depolanan $Session nesneleri tarafından tanımlanan bilgisayarlar için yapılandırmayı test eder. Bu durumda Server01 adlı bilgisayar.

Örnek 3: Ayrıntılı sonuçlarla test yapılandırmaları

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

Bu komut, ComputerName parametresi tarafından belirtilen bir bilgisayar kümesi için yapılandırmaları test eder ve genel durumu, istenen durumdaki kaynakları, istenen durumda olmayan kaynakları ve bilgisayar adını içeren ayrıntılı bilgileri döndürür.

Örnek 4: Bir klasörde belirtilen test yapılandırmaları

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Bu komut, Path parametresi tarafından belirtilen bir klasörde tanımlanan yapılandırmaları test eder. Yapılandırmalar, her biri yapılandırma dosyasının dosya adıyla tanımlanan bir bilgisayar kümesine göre test edilir.

Örnek 5: Bir dosyada belirtilen test yapılandırmaları

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

Bu komut, bir dosyada tanımlanan yapılandırmayı, ComputerName parametresi tarafından belirtilen bir bilgisayar kümesine karşı test ediyor.

Parametreler

-AsJob

Bu cmdlet'in komutu arka plan işi olarak çalıştırdığını gösterir.

AsJob parametresini belirtirseniz, komut işi temsil eden bir nesne döndürür ve komut istemini görüntüler. İş bitene kadar oturumda çalışmaya devam edebilirsiniz. İş yerel bilgisayarda oluşturulur ve uzak bilgisayarlardan alınan sonuçlar otomatik olarak yerel bilgisayara döndürülür. İşi yönetmek için İş cmdlet'lerini kullanın. İş sonuçlarını almak için Receive-Job cmdlet'ini kullanın.

Bu parametreyi kullanmak için yerel ve uzak bilgisayarların uzaktan iletişim için yapılandırılması ve Windows Vista'da ve Windows işletim sisteminin sonraki sürümlerinde Windows PowerShell'i Yönetici olarak çalıştır seçeneğiyle açmanız gerekir. Daha fazla bilgi için bkz. about_Remote_Requirements.

Windows PowerShell arka plan işleri hakkında daha fazla bilgi için bkz. about_Jobs ve about_Remote_Jobs.

Parametre özellikleri

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

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İş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

-CimSession

Cmdlet'i uzak oturumda veya uzak bir bilgisayarda çalıştırır. New-CimSession çıkışı veya Get-CimSession cmdlet'i gibi bir bilgisayar adı veya oturum nesnesi girin. Varsayılan, yerel bilgisayardaki geçerli oturumdur.

Parametre özellikleri

Tür:	CimSession[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

CimSessionAndPathSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	True
Ö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

CimSessionAndReferenceConfigurationSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	True
Ö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

CimSessionSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	True
Ö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

-ComputerName

Bu cmdlet'in yapılandırmayı test ettiği bilgisayar adları dizisini belirtir. Cmdlet, yapılandırma belgesini bu bilgisayarlara Path parametresi tarafından belirtilen konumda test eder.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Çin, SunucuAdı

Parametre kümeleri

ComputerNameSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	True
Ö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

ComputerNameAndPathSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	True
Ö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

ComputerNameAndReferenceConfigurationSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	True
Ö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

-Credential

Hedef bilgisayar için PSCredential nesnesi olarak bir kullanıcı adı ve parola belirtir. PSCredential nesnesi edinmek için Get-Credential cmdlet'ini kullanın. Daha fazla bilgi için Get-Help Get-Credentialyazın.

Parametre özellikleri

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

Parametre kümeleri

ComputerNameSet

Position:	Named
Zorunlu:	False
İş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

ComputerNameAndPathSet

Position:	Named
Zorunlu:	False
İş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

ComputerNameAndReferenceConfigurationSet

Position:	Named
Zorunlu:	False
İş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

-Detailed

Bu cmdlet'in yapılandırma belgesini düğümlerin istenen durumuyla karşılaştırmanın ayrıntılı bir sonucunu döndürdüğünü gösterir. Sonuç genel durum, istenen durumdaki kaynaklar, istenen durumda olmayan kaynaklar ve bilgisayar adı gibi bilgileri içerir.

Parametre özellikleri

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

Parametre kümeleri

ComputerNameSet

Position:	Named
Zorunlu:	False
İş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

CimSessionSet

Position:	Named
Zorunlu:	False
İş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

-Path

Yapılandırma belgesi dosyalarını içeren bir klasörün yolunu belirtir. Cmdlet, yapılandırmasını ComputerName veya cimSession parametresi tarafından belirtilen bilgisayarların istenen durumuna göre test eder.

Parametre özellikleri

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

Parametre kümeleri

ComputerNameAndPathSet

Position:	0
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

CimSessionAndPathSet

Position:	0
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

-ReferenceConfiguration

Yapılandırma belgesi dosyasının yolunu belirtir. Bu cmdlet, yapılandırmasını, ComputerName veya CimSession parametresi tarafından belirtilen bilgisayarların gerçek durumuna göre test eder.

Parametre özellikleri

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

Parametre kümeleri

ComputerNameAndReferenceConfigurationSet

Position:	Named
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

CimSessionAndReferenceConfigurationSet

Position:	Named
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

-ThrottleLimit

cmdlet'ini çalıştırmak için oluşturulabilecek en fazla eşzamanlı işlem sayısını belirtir. Bu parametre atlanırsa veya 0 değeri girilirse, Windows PowerShell bilgisayarda çalışan CIM cmdlet'lerinin sayısına göre cmdlet için en uygun azaltma sınırını hesaplar. Kısıtlama sınırı yalnızca geçerli cmdlet'e uygulanır, oturuma veya bilgisayara uygulanmaz.

Parametre özellikleri

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

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İş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.

İlişkili Bağlantılar

• Windows PowerShell İstenen Durum Yapılandırmasına Genel Bakış
• Get-DscConfiguration
• Get-DscConfigurationStatus
• Restore-DscConfiguration
• Start-DscConfiguration