Test-PSSessionConfigurationFile

  • Reference
Modul:
Microsoft.PowerShell.Core

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ěří 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ěřuje 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 s omezeným přístupem. Hodnota parametru Path je výsledkem Get-PSSessionConfiguration příkazu, který získá konfiguraci omezené relace. Cesta konfiguračního souboru relace je uložena v hodnotě vlastnosti ConfigFilePath 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á (prints) hodnotu vlastnosti ConfigFilePath . Potom pomocí rutiny Test-PSSessionConfigurationFile otestuje soubor v hodnotě ConfigFilePath . Podrobný parametr 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-PSSessionConfigurationFilesouboru .

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

Vstupy

String

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

Výstupy

Boolean

Poznámky

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