Test-PSSessionConfigurationFile

Modul:: Microsoft.PowerShell.Core Module

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

Syntax

Default (Výchozí)

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 nalezení chyb použijte parametr Verbose.

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.

Tento cmdlet byl zaveden 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 konfigurace relace

V tomto příkladu testujeme konfigurační soubor použitý v nastavení relace Restricted. Hodnota parametru Path je výsledkem příkazu Get-PSSessionConfiguration, který získává 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 (cmdlet) Get-PSSessionConfiguration k získání všech konfigurací relací. Kód ve smyčce ForEach-Object zobrazuje cestu k souboru a testuje 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 neprojde testem.

Parametry

-Path

Určuje cestu a název souboru s konfigurací 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é předat cestu ke konfiguračnímu souboru relace do Test-PSSessionConfigurationFile.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

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

Výstupy

Boolean

Poznámky

Tento cmdlet je dostupný pouze na platformách Windows.

Sdílet prostřednictvím