Číst v angličtině

Sdílet prostřednictvím

Test-PSSessionConfigurationFile

  • Reference
Modul:
Microsoft.PowerShell.Core

Ověří klíče a hodnoty v konfiguračním souboru relace.

Syntaxe

PowerShell 
Test-PSSessionConfigurationFile
    [-Path] <String>
    [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Tato rutina ověří, že konfigurační soubor relace obsahuje platné klíče a hodnoty jsou správného typu. U výčtových hodnot rutina ověří platnost zadaných hodnot.

Cmdlet vrátí $True, pokud soubor projde všemi testy a $False, pokud ne. K vyhledání chyb použijte parametr Podrobný.

Test-PSSessionConfigurationFile ověří konfigurační soubory relace, jako jsou například konfigurační soubory vytvořené rutinou New-PSSessionConfigurationFile. Informace o konfiguracích relací najdete v tématu about_Session_Configurations. Informace o souborech konfigurace relací najdete v tématu about_Session_Configuration_Files.

Tato cmdlet byla představena v PowerShellu 3.0.

Příklady

Příklad 1: Testování konfiguračního souboru relace

PowerShell 
Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Příklad 2: Otestování konfiguračního souboru konfigurace relace

V tomto příkladu otestujeme konfigurační soubor použitý v konfiguraci relace Restricted. Hodnota parametru Path je výsledkem příkazu Get-PSSessionConfiguration, který získá konfiguraci relace Restricted. Cesta konfiguračního souboru relace je uložena v hodnotě ConfigFilePath vlastnosti konfigurace relace.

PowerShell 
Test-PSSessionConfigurationFile -Path (Get-PSSessionConfiguration -Name Restricted).ConfigFilePath

Příklad 3: Testování všech konfiguračních souborů relací

Funkce v tomto příkladu testuje všechny konfigurační soubory relace na místním počítači. Funkce používá rutinu (cmdlet) Get-PSSessionConfiguration k získání všech konfigurací relací. Kód uvnitř smyčky ForEach-Object zobrazí cestu k souboru a otestuje každou konfiguraci relace.

PowerShell 
function Test-AllConfigFiles
{
    Get-PSSessionConfiguration | ForEach-Object {
        if ($_.ConfigFilePath) {
            $_.ConfigFilePath
            Test-PSSessionConfigurationFile -Verbose -Path $_.ConfigFilePath
        }
    }
}
Test-AllConfigFiles

C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Empty_6fd77bf6-e084-4372-bd8a-af3e207354d3.pssc
True
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Full_1e9cb265-dae0-4bd3-89a9-8338a47698a1.pssc
VERBOSE: The member 'AliasDefinitions' must contain the required key 'Description'. Add the require key
to the fileC:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Full_1e9cb265-dae0-4bd3-89a9-8338a47698a1.pssc.
False
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\NoLanguage_0c115179-ff2a-4f66-a5eb-e56e5692ba22.pssc
True
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\RestrictedLang_b6bd9474-0a6c-4e06-8722-c2c95bb10d3e.pssc
True
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\RRS_3fb29420-2c87-46e5-a402-e21436331efc.pssc
True

Vlastnost ConfigFilePath konfigurace relace obsahuje cestu konfiguračního souboru relace, který se používá v konfiguraci relace, pokud existuje.

Pokud je hodnota vlastnosti ConfigFilePath naplněna (je true), příkaz získá (vytiskne) hodnotu vlastnosti ConfigFilePath. Potom pomocí rutiny Test-PSSessionConfigurationFile otestuje soubor v hodnotě ConfigFilePath. Parametr Podrobný vrátí chybu souboru, pokud soubor neprojde testem.

Parametry

-Path

Určuje cestu a název souboru konfigurace relace (.pssc). Pokud tuto cestu vynecháte, výchozí je aktuální složka. Podporují se zástupné znaky, ale musí odpovídat jednomu souboru. Můžete také poslat cestu ke konfiguračnímu souboru relace do Test-PSSessionConfigurationFile.

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

Vstupy

String

K této rutině můžete připojit cestu ke konfiguračnímu souboru relace.

Výstupy

Boolean

Poznámky

Tento příkaz cmdlet je dostupný jenom na platformách Windows.