Test-PSSessionConfigurationFile

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

Syntax

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ěří, že zadané hodnoty jsou platné.

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, například 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 zavedena 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 s omezeným přístupem . Hodnota parametru Path je výsledkem Get-PSSessionConfiguration příkazu, který získá konfiguraci relace s omezeným přístupem . 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ů relace

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ř ForEach-Object smyčky 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á (tisk) hodnotu vlastnosti ConfigFilePath . Pak použije rutinu Test-PSSessionConfigurationFile k otestování souboru v hodnotě ConfigFilePath . Podrobný parametr vrátí chybu souboru, když soubor selže test.

Parametry

-Path

Určuje cestu a název souboru konfiguračního souboru relace (.pssc). Pokud cestu vynecháte, výchozí hodnota 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 konfiguračního souboru relace k Test-PSSessionConfigurationFile.

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

Vstupy

String

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

Výstupy

Boolean

Poznámky

Tato rutina je dostupná jenom na platformách Windows.