Sdílet prostřednictvím

Test-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

Testuje, jestli skutečná konfigurace na uzlech odpovídá požadované konfiguraci.

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

Rutina Test-DscConfiguration testuje, jestli skutečná konfigurace na uzlech odpovídá požadované konfiguraci. Určete, pro které počítače chcete testovat konfigurace pomocí názvů počítačů nebo relací MODELU CIM (Common Information Model). Pokud nezadáte cílový počítač, rutina otestuje konfiguraci místního počítače.

Pokud se požadovaná a skutečná konfigurace shodují, rutina vrátí řetězcovou hodnotu True. V opačném případě vrátí řetězcovou hodnotu False.

Příklady

Příklad 1: Test konfigurace pro místní počítač

Test-DscConfiguration

Tento příkaz otestuje konfiguraci místního počítače.

Příklad 2: Test konfigurace pro zadaný počítač

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

Tento příklad otestuje konfiguraci z počítače určeného relací CIM. Příklad vytvoří relaci CIM pro počítač s názvem Server01 pro použití s rutinou. Případně můžete vytvořit pole relací CIM pro použití rutiny na více zadaných počítačů.

První příkaz vytvoří relaci CIM pomocí rutiny New-CimSession a pak uloží objekt CimSession do $Session proměnné. Příkaz vás vyzve k zadání hesla. Další informace zobrazíte zadáním Get-Help New-CimSession.

Druhý příkaz otestuje konfiguraci pro počítače identifikované objekty CimSession uložené v $Session proměnné, v tomto případě počítač s názvem Server01.

Příklad 3: Testování konfigurací s podrobnými výsledky

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

Tento příkaz testuje konfigurace pro sadu počítačů určených parametrem ComputerName a vrátí podrobné informace, které zahrnují celkový stav, prostředky, které jsou v požadovaném stavu, prostředky, které nejsou v požadovaném stavu, a název počítače.

Příklad 4: Testování konfigurací zadaných ve složce

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

Tento příkaz testuje konfigurace, které jsou definovány ve složce určené parametrem Path . Konfigurace jsou testovány na sadě počítačů, z nichž každý je označen názvem souboru konfiguračního souboru.

Příklad 5: Testování konfigurací zadaných v souboru

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

Tento příkaz otestuje konfiguraci definovanou v souboru se sadou počítačů určených parametrem ComputerName .

Parametry

-AsJob

Označuje, že tato rutina spustí příkaz jako úlohu na pozadí.

Pokud zadáte parametr AsJob , příkaz vrátí objekt, který představuje úlohu, a pak zobrazí příkazový řádek. V relaci můžete pokračovat v práci, dokud se úloha nedokončí. Úloha se vytvoří v místním počítači a výsledky ze vzdálených počítačů se automaticky vrátí do místního počítače. Ke správě úlohy použijte rutiny úlohy. Pokud chcete získat výsledky úlohy, použijte rutinu Receive-Job .

Chcete-li použít tento parametr, musí být místní a vzdálené počítače nakonfigurovány pro vzdálenou komunikace a v systému Windows Vista a novějších verzích operačního systému Windows musíte otevřít Windows PowerShell s možností Spustit jako správce. Další informace najdete v tématu about_Remote_Requirements.

Další informace o úlohách Windows PowerShell na pozadí najdete v tématu about_Jobs a about_Remote_Jobs.

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

-CimSession

Spustí rutinu ve vzdálené relaci nebo na vzdáleném počítači. Zadejte název počítače nebo objekt relace, například výstup rutiny New-CimSession nebo Get-CimSession . Výchozí hodnota je aktuální relace v místním počítači.

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

-ComputerName

Určuje pole názvů počítačů, na kterých tato rutina testuje konfiguraci. Rutina testuje konfigurační dokument v umístění určeném parametrem Path k těmto počítačům.

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

-Credential

Určuje uživatelské jméno a heslo jako objekt PSCredential pro cílový počítač. K získání objektu PSCredential použijte rutinu Get-Credential . Další informace zobrazíte zadáním Get-Help Get-Credential.

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

-Detailed

Označuje, že tato rutina vrátí podrobný výsledek porovnání konfiguračního dokumentu s požadovaným stavem uzlů. Výsledek obsahuje informace, jako je celkový stav, prostředky, které jsou v požadovaném stavu, prostředky, které nejsou v požadovaném stavu, a název počítače.

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

-Path

Určuje cestu ke složce, která obsahuje soubory konfiguračního dokumentu. Rutina testuje konfiguraci podle požadovaného stavu počítačů určených parametrem ComputerName nebo CimSession .

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

-ReferenceConfiguration

Určuje cestu k souboru konfiguračního dokumentu. Tato rutina testuje konfiguraci na základě skutečného stavu počítačů určených parametrem ComputerName nebo CimSession .

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

-ThrottleLimit

Určuje maximální počet souběžných operací, které lze vytvořit pro spuštění rutiny. Pokud je tento parametr vynechán nebo je zadána hodnota0, pak Windows PowerShell vypočítá optimální limit omezení pro rutinu na základě počtu rutin CIM spuštěných v počítači. Omezení omezení se vztahuje pouze na aktuální rutinu, nikoli na relaci nebo na počítač.

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