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. Pro výčtové hodnoty rutina ověří, jestli jsou zadané hodnoty platné.

Rutina vrátí $True , pokud soubor projde všemi testy a $False pokud ne. Pokud chcete najít případné chyby, použijte parametr Verbose .

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: Testová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ů relací

Funkce v tomto příkladu testuje všechny konfigurační soubory relace v 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 k konfiguračnímu souboru relace, který se používá v konfiguraci relace, pokud existuje.

Pokud je naplněna hodnota vlastnosti ConfigFilePath (je true), příkaz získá (vytiskne) hodnotu vlastnosti ConfigFilePath . Pak použije rutinu Test-PSSessionConfigurationFile k otestování souboru v hodnotě ConfigFilePath . Parametr Verbose vrátí chybu souboru, když soubor selže v testu.

Parametry

-Path

Určuje cestu a název souboru konfiguračního souboru relace (.pssc). Pokud cestu vynecháte, výchozí je aktuální složka. Zástupné znaky jsou podporované, ale musí se přeložit na jeden soubor. Cestu k konfiguračnímu souboru relace můžete také nasměrovat do Test-PSSessionConfigurationFile.

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

Vstupy

String

Do této rutiny můžete připojit cestu konfiguračního souboru relace.

Výstupy

Boolean

Poznámky

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