Test-DscConfiguration
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 |
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: