Test-DscConfiguration

  • Referencia
Modul:
PSDesiredStateConfiguration

Ellenőrzi, hogy a csomópontok tényleges konfigurációja megegyezik-e a kívánt konfigurációval.

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

A Test-DscConfiguration parancsmag ellenőrzi, hogy a csomópontok tényleges konfigurációja megegyezik-e a kívánt konfigurációval. Adja meg, hogy mely számítógépeken szeretné tesztelni a konfigurációkat a számítógépnevek vagy a Common Information Model (CIM) munkamenetek használatával. Ha nem ad meg célszámítógépet, a parancsmag teszteli a helyi számítógép konfigurációját.

Ha a kívánt és a tényleges konfiguráció megegyezik, a parancsmag "Igaz" sztringértéket ad vissza. Ellenkező esetben a "False" sztringértéket adja vissza.

Példák

1. példa: A helyi számítógép konfigurációjának tesztelése

Test-DscConfiguration

Ez a parancs teszteli a helyi számítógép konfigurációját.

2. példa: Adott számítógép konfigurációjának tesztelése

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

Ez a példa egy CIM-munkamenet által megadott számítógép konfigurációját teszteli. A példa létrehoz egy CIM-munkamenetet egy Server01 nevű számítógéphez a parancsmaggal való használatra. Másik lehetőségként hozzon létre egy CIM-munkamenetekből álló tömböt, amellyel a parancsmagot több megadott számítógépre alkalmazhatja.

Az első parancs létrehoz egy CIM-munkamenetet a New-CimSession parancsmag használatával, majd tárolja a CimSession objektumot a $Session változóban. A parancssor jelszó megadását kéri. További információért írja be a következőt: Get-Help New-CimSession.

A második parancs a Változóban $Session tárolt CimSession objektumok által azonosított számítógépek konfigurációját teszteli, ebben az esetben a Server01 nevű számítógépet.

3. példa: Konfigurációk tesztelése részletes eredményekkel

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

Ez a parancs a ComputerName paraméter által meghatározott számítógépek konfigurációit teszteli, és részletes információkat ad vissza, amelyek tartalmazzák a teljes állapotot, a kívánt állapotban lévő erőforrásokat, a nem a kívánt állapotban lévő erőforrásokat és a számítógép nevét.

4. példa: Egy mappában megadott konfigurációk tesztelése

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

Ez a parancs az Elérési út paraméter által meghatározott mappában definiált konfigurációkat teszteli. A konfigurációkat a rendszer számítógépeken teszteli, amelyeket a konfigurációs fájl fájlneve azonosít.

5. példa: Fájlban megadott konfigurációk tesztelése

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

Ez a parancs egy fájlban definiált konfigurációt tesztel a ComputerName paraméter által meghatározott számítógépeken.

Paraméterek

-AsJob

Azt jelzi, hogy ez a parancsmag háttérfeladatként futtatja a parancsot.

Ha megadja az AsJob paramétert, a parancs egy objektumot ad vissza, amely a feladatot jelöli, majd megjeleníti a parancssort. A munkamenetben a feladat befejezéséig folytathatja a munkát. A feladat a helyi számítógépen jön létre, és a távoli számítógépek eredményei automatikusan visszakerülnek a helyi számítógépre. A feladat kezeléséhez használja a Feladat parancsmagokat. A feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.

A paraméter használatához konfigurálni kell a helyi és a távoli számítógépeket az újrahangoláshoz, a Windows Vista és a Windows operációs rendszer újabb verzióiban pedig a Futtatás rendszergazdaként beállítással kell megnyitnia a Windows PowerShell. További információ: about_Remote_Requirements.

A Windows PowerShell háttérfeladatokkal kapcsolatos további információkért lásd: about_Jobs és about_Remote_Jobs.

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

-CimSession

Távoli munkamenetben vagy távoli számítógépen futtatja a parancsmagot. Adjon meg egy számítógépnevet vagy munkamenet-objektumot, például egy New-CimSession vagy Get-CimSession parancsmag kimenetét. Az alapértelmezett beállítás az aktuális munkamenet a helyi számítógépen.

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

-ComputerName

Megadja a számítógépnevek tömböt, amelyen ez a parancsmag teszteli a konfigurációt. A parancsmag a konfigurációs dokumentumot az Elérési út paraméter által megadott helyen teszteli ezen számítógépeken.

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

-Credential

Megadja a célszámítógéphez tartozó felhasználónevet és jelszót PSCredential objektumként. PSCredential objektum beszerzéséhez használja a Get-Credential parancsmagot. További információért írja be a következőt: Get-Help Get-Credential.

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

-Detailed

Azt jelzi, hogy ez a parancsmag a konfigurációs dokumentum és a csomópontok kívánt állapotának összehasonlításának részletes eredményét adja vissza. Az eredmény olyan információkat tartalmaz, mint a teljes állapot, a kívánt állapotban lévő erőforrások, a nem kívánt állapotú erőforrások és a számítógép neve.

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

-Path

Megadja a konfigurációs dokumentumfájlokat tartalmazó mappa elérési útját. A parancsmag ellenőrzi a konfigurációt a ComputerName vagy a CimSession paraméter által meghatározott számítógépek kívánt állapotán.

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

-ReferenceConfiguration

Megadja a konfigurációs dokumentumfájl elérési útját. Ez a parancsmag ellenőrzi a konfigurációt a ComputerName vagy a CimSession paraméter által megadott számítógépek tényleges állapotán.

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

-ThrottleLimit

Megadja a parancsmag futtatásához létrehozható egyidejű műveletek maximális számát. Ha ezt a paramétert nem adja meg, vagy egy értéket 0 ad meg, akkor Windows PowerShell kiszámítja a parancsmag optimális szabályozási korlátját a számítógépen futó CIM-parancsmagok száma alapján. A szabályozási korlát csak az aktuális parancsmagra vonatkozik, a munkamenetre és a számítógépre nem.

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