Test-DscConfiguration

  • Referensi
Modul:
PSDesiredStateConfiguration

Menguji apakah konfigurasi aktual pada simpul cocok dengan konfigurasi yang diinginkan.

Sintaks

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>]

Deskripsi

Test-DscConfiguration Cmdlet menguji apakah konfigurasi aktual pada simpul cocok dengan konfigurasi yang diinginkan. Tentukan komputer mana yang ingin Anda uji konfigurasinya dengan menggunakan nama komputer atau sesi Common Information Model (CIM). Jika Anda tidak menentukan komputer target, cmdlet menguji konfigurasi komputer lokal.

Jika konfigurasi yang diinginkan dan aktual cocok, cmdlet mengembalikan nilai string 'True'. Jika tidak, ia mengembalikan nilai string 'False'.

Contoh

Contoh 1: Menguji konfigurasi untuk komputer lokal

Test-DscConfiguration

Perintah ini menguji konfigurasi untuk komputer lokal.

Contoh 2: Menguji konfigurasi untuk komputer tertentu

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

Contoh konfigurasi pengujian dari komputer yang ditentukan oleh sesi CIM. Contohnya membuat sesi CIM untuk komputer bernama Server01 untuk digunakan dengan cmdlet . Atau, buat array sesi CIM untuk menerapkan cmdlet ke beberapa komputer tertentu.

Perintah pertama membuat sesi CIM dengan menggunakan New-CimSession cmdlet , lalu menyimpan objek CimSession dalam $Session variabel . Perintah meminta kata sandi kepada Anda. Untuk informasi selengkapnya, ketik Get-Help New-CimSession.

Perintah kedua menguji konfigurasi untuk komputer yang diidentifikasi oleh objek CimSession yang disimpan dalam $Session variabel, dalam hal ini, komputer bernama Server01.

Contoh 3: Menguji konfigurasi dengan hasil terperinci

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

Perintah ini menguji konfigurasi untuk sekumpulan komputer yang ditentukan oleh parameter ComputerName dan mengembalikan informasi terperinci yang mencakup status keseluruhan, sumber daya yang berada dalam status yang diinginkan, sumber daya yang tidak dalam status yang diinginkan dan nama komputer.

Contoh 4: Konfigurasi pengujian yang ditentukan dalam folder

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

Perintah ini menguji konfigurasi yang ditentukan dalam folder yang ditentukan oleh parameter Jalur . Konfigurasi diuji terhadap sekumpulan komputer, masing-masing diidentifikasi dengan nama file file konfigurasi.

Contoh 5: Konfigurasi pengujian yang ditentukan dalam file

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

Perintah ini menguji konfigurasi yang ditentukan dalam file terhadap sekumpulan komputer yang ditentukan oleh parameter ComputerName .

Parameter

-AsJob

Menunjukkan bahwa cmdlet ini menjalankan perintah sebagai pekerjaan latar belakang.

Jika Anda menentukan parameter AsJob , perintah mengembalikan objek yang mewakili pekerjaan, lalu menampilkan prompt perintah. Anda dapat terus bekerja dalam sesi hingga pekerjaan selesai. Pekerjaan dibuat pada komputer lokal dan hasil dari komputer jarak jauh secara otomatis dikembalikan ke komputer lokal. Untuk mengelola pekerjaan, gunakan cmdlet Pekerjaan. Untuk mendapatkan hasil pekerjaan, gunakan Receive-Job cmdlet .

Untuk menggunakan parameter ini, komputer lokal dan jarak jauh harus dikonfigurasi untuk jarak jauh, dan pada Windows Vista dan versi sistem operasi Windows yang lebih baru, Anda harus membuka Windows PowerShell dengan opsi Jalankan sebagai administrator. Untuk informasi selengkapnya, lihat about_Remote_Requirements.

Untuk informasi selengkapnya tentang pekerjaan latar belakang Windows PowerShell, lihat about_Jobs dan about_Remote_Jobs.

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

-CimSession

Menjalankan cmdlet dalam sesi jarak jauh atau di komputer jarak jauh. Masukkan nama komputer atau objek sesi, seperti output cmdlet New-CimSession atau Get-CimSession . Defaultnya adalah sesi saat ini pada komputer lokal.

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

-ComputerName

Menentukan array nama komputer tempat cmdlet ini menguji konfigurasi. Cmdlet menguji dokumen konfigurasi di lokasi yang ditentukan oleh parameter Jalur ke komputer ini.

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

-Credential

Menentukan nama pengguna dan kata sandi, sebagai objek PSCredential , untuk komputer target. Untuk mendapatkan objek PSCredential , gunakan Get-Credential cmdlet . Untuk informasi selengkapnya, ketik Get-Help Get-Credential.

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

-Detailed

Menunjukkan bahwa cmdlet ini mengembalikan hasil terperinci dari membandingkan dokumen konfigurasi dengan status simpul yang diinginkan. Hasilnya mencakup informasi seperti status keseluruhan, sumber daya yang berada dalam status yang diinginkan, sumber daya yang tidak dalam keadaan yang diinginkan, dan nama komputer.

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

-Path

Menentukan jalur folder yang berisi file dokumen konfigurasi. Cmdlet menguji konfigurasi terhadap status komputer yang diinginkan yang ditentukan oleh parameter ComputerName atau CimSession .

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

-ReferenceConfiguration

Menentukan jalur file dokumen konfigurasi. Cmdlet ini menguji konfigurasi terhadap status aktual komputer yang ditentukan oleh parameter ComputerName atau CimSession .

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

-ThrottleLimit

Menentukan jumlah maksimum operasi bersamaan yang dapat ditetapkan untuk menjalankan cmdlet. Jika parameter ini dihilangkan atau nilai 0 dimasukkan, maka Windows PowerShell menghitung batas pembatasan optimal untuk cmdlet berdasarkan jumlah cmdlet CIM yang berjalan di komputer. Batas pembatasan hanya berlaku untuk cmdlet saat ini, bukan ke sesi atau ke komputer.

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