Megosztás a következőn keresztül:

Test-DscConfiguration

Modul:
PSDesiredStateConfiguration Module v1.1

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

Syntax

ComputerNameSet (Alapértelmezett) 

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

A Test-DscConfiguration parancsmag ellenőrzi, hogy a csomópontok tényleges konfigurációja megfelel-e a kívánt konfigurációnak. 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 a "True" sztringértéket adja vissza. Ellenkező esetben "False" karakterláncértéket ad 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 is alkalmazhatja.

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

A második parancs a CimSession$Session változóban tárolt objektumok konfigurációját teszteli, ebben az esetben a Server01 nevű számítógépen.

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 megadott 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 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 a Elérési út paraméter által meghatározott mappában definiált konfigurációkat teszteli. A konfigurációk tesztelése számítógépeken, amelyek mindegyike a konfigurációs fájl fájlneve alapján van azonosítva.

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 megadott számítógépeken.

Paraméterek

-AsJob

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

Ha megadja a AsJob paramétert, a parancs egy, a feladatot jelképező objektumot ad vissza, 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 a helyi és a távoli számítógépeket újra kell konfigurálni, a Windows Vista és a Windows operációs rendszer újabb verzióiban pedig a Windows PowerShellt a Futtatás rendszergazdaként lehetőséggel kell megnyitnia. További információkért lásd: about_Remote_Requirements.

További információ a Windows PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-CimSession

A parancsmagot távoli munkamenetben vagy távoli számítógépen futtatja. 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 az aktuális munkamenet a helyi számítógépen.

Paramétertulajdonságok

Típus:

CimSession[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

CimSessionAndPathSet
Position:Named
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
CimSessionAndReferenceConfigurationSet
Position:Named
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
CimSessionSet
Position:Named
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ComputerName

Olyan számítógépneveket tartalmazó tömböt ad meg, amelyen ez a parancsmag teszteli a konfigurációt. A parancsmag a konfigurációs dokumentumot a Elérési út paraméter által megadott helyen teszteli ezekre a számítógépekre.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Kína, Kiszolgálónév

Paraméterkészletek

ComputerNameSet
Position:1
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
ComputerNameAndPathSet
Position:1
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
ComputerNameAndReferenceConfigurationSet
Position:1
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Credential

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

Paramétertulajdonságok

Típus:PSCredential
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerNameSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
ComputerNameAndPathSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
ComputerNameAndReferenceConfigurationSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerNameSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
CimSessionSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Path

Megadja a konfigurációs dokumentumfájlokat tartalmazó mappa elérési útját. A parancsmag a konfigurációt a ComputerName vagy CimSession paraméter által megadott kívánt állapoton teszteli.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerNameAndPathSet
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
CimSessionAndPathSet
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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 CimSession paraméter által megadott számítógépek tényleges állapotán.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerNameAndReferenceConfigurationSet
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
CimSessionAndReferenceConfigurationSet
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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 0 értéket ad meg, akkor a Windows PowerShell a számítógépen futó CIM-parancsmagok száma alapján kiszámítja a parancsmag optimális szabályozási korlátját. A szabályozási korlát csak az aktuális parancsmagra vonatkozik, a munkamenetre és a számítógépre nem.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.