Sdílet prostřednictvím

Test-PSSessionConfigurationFile

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntaxe

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

Description

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.

Rutina 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 konfiguračních souborech relací najdete v tématu about_Session_Configuration_Files.

Tato rutina byla představena v PowerShellu 3.0.

Příklady

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

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Příklad 2: Otestování konfiguračního souboru relace 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.

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 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.

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, když soubor selže test.

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í se přeložit na jeden soubor. Můžete také připojit 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:False

Vstupy

String

Cestu ke konfiguračnímu souboru relace můžete připojit ke Test-PSSessionConfigurationFile.

Výstupy

Boolean