Test-PSSessionConfigurationFile

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

Weryfikuje klucze i wartości w pliku konfiguracji sesji.

Składnia

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

Opis

To polecenie cmdlet sprawdza, czy plik konfiguracji sesji zawiera prawidłowe klucze, a wartości są poprawne. W przypadku wyliczonych wartości polecenie cmdlet sprawdza, czy określone wartości są prawidłowe.

Polecenie cmdlet zwraca $True wartość , jeśli plik przejdzie wszystkie testy i $False jeśli nie. Aby znaleźć błędy, użyj parametru Verbose .

Test-PSSessionConfigurationFile Sprawdza pliki konfiguracji sesji, takie jak te utworzone przez New-PSSessionConfigurationFile polecenie cmdlet. Aby uzyskać informacje na temat konfiguracji sesji, zobacz about_Session_Configurations. Aby uzyskać informacje o plikach konfiguracji sesji, zobacz about_Session_Configuration_Files.

To polecenie cmdlet zostało wprowadzone w programie PowerShell 3.0.

Przykłady

Przykład 1. Testowanie pliku konfiguracji sesji

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Przykład 2: Testowanie pliku konfiguracji sesji konfiguracji sesji

W tym przykładzie przetestujemy plik konfiguracji używany w konfiguracji sesji z ograniczeniami . Wartość parametru Path jest wynikiem Get-PSSessionConfiguration polecenia, które pobiera konfigurację sesji z ograniczeniami . Ścieżka pliku konfiguracji sesji jest przechowywana w wartości właściwości ConfigFilePath konfiguracji sesji.

Test-PSSessionConfigurationFile -Path (Get-PSSessionConfiguration -Name Restricted).ConfigFilePath

Przykład 3. Testowanie wszystkich plików konfiguracji sesji

Funkcja w tym przykładzie testuje wszystkie pliki konfiguracji sesji na komputerze lokalnym. Funkcja używa polecenia cmdlet do pobierania Get-PSSessionConfiguration wszystkich konfiguracji sesji. Kod wewnątrz ForEach-Object pętli wyświetla ścieżkę pliku i testuje każdą konfigurację sesji.

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

Właściwość ConfigFilePath konfiguracji sesji zawiera ścieżkę pliku konfiguracji sesji, który jest używany w konfiguracji sesji, jeśli istnieje.

Jeśli wartość właściwości ConfigFilePath zostanie wypełniona (ma wartość true), polecenie pobiera (drukuje) wartość właściwości ConfigFilePath. Następnie używa Test-PSSessionConfigurationFile polecenia cmdlet do testowania pliku w wartości ConfigFilePath . Parametr Verbose zwraca błąd pliku, gdy plik zakończy się niepowodzeniem testu.

Parametry

-Path

Określa ścieżkę i nazwę pliku konfiguracji sesji (pssc). Jeśli pominięto ścieżkę, wartość domyślna to bieżący folder. Obsługiwane są symbole wieloznaczne, ale muszą być rozpoznawane jako pojedynczy plik. Możesz również przekazać ścieżkę pliku konfiguracji sesji do Test-PSSessionConfigurationFile.

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

Dane wejściowe

String

Możesz przekazać ścieżkę pliku konfiguracji sesji do tego polecenia cmdlet.

Dane wyjściowe

Boolean