Sdílet prostřednictvím

Test-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

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

Syntaxe

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í CIM (Common Information Model). Pokud cílovou počítač nezadáte, rutina testuje konfiguraci místního počítače.

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

Příklady

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

Test-DscConfiguration

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

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

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

Tento příklad testovací konfigurace 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, které použije rutinu na více zadaných počítačů.

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

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

Příklad 3: Konfigurace testů 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: Testovací konfigurace zadané ve složce

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

Tento příkaz testuje konfigurace definované ve složce určené parametrem Path. Konfigurace se testují na sadě počítačů, které jsou identifikované názvem souboru konfiguračního souboru.

Příklad 5: Testovací konfigurace zadané v souboru

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

Tento příkaz testuje konfiguraci definovanou v souboru proti sadě počítačů určených parametrem ComputerName.

Parametry

-AsJob

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

Pokud zadáte parametr AsJob, vrátí příkaz 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. K získání výsledků ú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 vzdálenou správu a v systému Windows Vista a novějších verzích operačního systému Windows, musíte otevřít Prostředí Windows PowerShell s možností Spustit jako správce. Další informace naleznete v tématu about_Remote_Requirements.

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CimSession

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

Typ:CimSession[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

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

Typ:String[]
Aliasy:CN, ServerName
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Credential

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

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

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

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ReferenceConfiguration

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

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ThrottleLimit

Určuje maximální počet souběžných operací, které lze navázat pro spuštění rutiny. Pokud tento parametr vynecháte nebo zadáte hodnotu 0, 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í se vztahuje pouze na aktuální rutinu, ne na relaci nebo na počítač.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False