Udostępnij za pośrednictwem

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 jest dostępne tylko na platformie Windows.

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

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

Test-PSSessionConfigurationFile Weryfikuje pliki konfiguracji sesji, takie jak te utworzone przez New-PSSessionConfigurationFile polecenie cmdlet. Aby uzyskać informacje o konfiguracjach 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 jest wypełniona (jest true), polecenie pobiera (drukuje) wartość właściwości ConfigFilePath . Następnie używa polecenia cmdlet do testowania Test-PSSessionConfigurationFile 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ścią domyślną jest bieżący folder. Obsługiwane są symbole wieloznaczne, ale muszą zostać rozpoznane 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

Ścieżkę pliku konfiguracji sesji można przekazać do Test-PSSessionConfigurationFilepliku .

Dane wyjściowe

Boolean

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach systemu Windows.