Freigeben über

Test-PSSessionConfigurationFile

  • Referenz
Modul:
Microsoft.PowerShell.Core

Überprüft die Schlüssel und Werte in einer Sitzungskonfigurationsdatei.

Syntax

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Dieses Cmdlet überprüft, ob eine Sitzungskonfigurationsdatei gültige Schlüssel enthält und die Werte vom richtigen Typ sind. Bei aufgezählten Werten überprüft das Cmdlet, ob die angegebenen Werte gültig sind.

Das Cmdlet gibt $True zurück, wenn die Datei alle Tests bestanden hat, und $False, wenn dies nicht der Fall ist. Um Fehler zu finden, verwenden Sie den Parameter Verbose.

Test-PSSessionConfigurationFile überprüft die Sitzungskonfigurationsdateien, z. B. die vom Cmdlet New-PSSessionConfigurationFile erstellten Dateien. Informationen zu Sitzungskonfigurationen finden Sie unter about_Session_Configurations. Informationen zu Sitzungskonfigurationsdateien finden Sie unter about_Session_Configuration_Files.

Dieses Cmdlet wurde in PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Testen einer Sitzungskonfigurationsdatei

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Beispiel 2: Testen der Sitzungskonfigurationsdatei einer Sitzungskonfiguration

In diesem Beispiel testen wir die Konfigurationsdatei, die in der Konfiguration der Restricted Sitzung verwendet wird. Der Wert des Path-Parameters ist das Ergebnis des befehls Get-PSSessionConfiguration, der die konfiguration der Restricted Sitzung abruft. Der Pfad der Sitzungskonfigurationsdatei wird im Wert der ConfigFilePath- Eigenschaft der Sitzungskonfiguration gespeichert.

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

Beispiel 3: Testen aller Sitzungskonfigurationsdateien

Die Funktion in diesem Beispiel testet alle Sitzungskonfigurationsdateien auf dem lokalen Computer. Die Funktion verwendet das Cmdlet Get-PSSessionConfiguration, um alle Sitzungskonfigurationen abzurufen. Der Code in der ForEach-Object Schleife zeigt den Dateipfad an und testet die einzelnen Sitzungskonfigurationen.

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

Die ConfigFilePath- Eigenschaft einer Sitzungskonfiguration enthält den Pfad der Sitzungskonfigurationsdatei, die in der Sitzungskonfiguration verwendet wird( falls vorhanden).

Wenn der Wert der ConfigFilePath--Eigenschaft aufgefüllt wird (ist wahr), ruft der Befehl den ConfigFilePath-Eigenschaftswert ab (druckt). Anschließend wird das cmdlet Test-PSSessionConfigurationFile verwendet, um die Datei im ConfigFilePath--Wert zu testen. Der parameter Verbose gibt den Dateifehler zurück, wenn die Datei den Test fehlschlägt.

Parameter

-Path

Gibt den Pfad und Dateinamen einer Sitzungskonfigurationsdatei (PSSC) an. Wenn Sie den Pfad weglassen, ist die Standardeinstellung der aktuelle Ordner. Wildcardzeichen werden unterstützt, müssen jedoch in eine einzelne Datei aufgelöst werden. Sie können auch einen Sitzungskonfigurationsdateipfad an Test-PSSessionConfigurationFileübergeben.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

Eingaben

String

Sie können einen Sitzungskonfigurationsdateipfad an dieses Cmdlet weiterleiten.

Ausgaben

Boolean

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.