Aracılığıyla paylaş

Test-DscConfiguration

  • Başvuru
Modül:
PSDesiredStateConfiguration

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

Syntax

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

Description

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

İ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ı test ediyor.

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

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

Bu örnek, CIM oturumu tarafından belirtilen bir bilgisayardan yapılandırmayı sınar. Ö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 cmdlet'ini New-CimSession kullanarak bir CIM oturumu oluşturur ve ardından CimSession nesnesini değişkeninde $Session depolar. Komut sizden bir parola ister. Daha fazla bilgi için Get-Help New-CimSession yazın.

İkinci komut, Değişkende depolanan CimSession nesneleri tarafından tanımlanan bilgisayarlar için yapılandırmayı $Session test eder, bu durumda, Sunucu01 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: 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: 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 gelen 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 cmdlet'ini Receive-Job kullanın.

Bu parametreyi kullanmak için yerel ve uzak bilgisayarların uzaktan iletişim için yapılandırılması ve Windows Vista ve Windows işletim sisteminin sonraki sürümlerinde yönetici olarak çalıştır seçeneğiyle Windows PowerShell 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.

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

-CimSession

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

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

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

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Path

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

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

-ReferenceConfiguration

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

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

-ThrottleLimit

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

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