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 Enumerationswerten überprüft das Cmdlet, ob die angegebenen Werte gültig sind.

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

Test-PSSessionConfigurationFile überprüft die Sitzungskonfigurationsdateien, z. B. die vom New-PSSessionConfigurationFile Cmdlet 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 eingeschränkten Sitzung verwendet wird. Der Wert des Path-Parameters ist das Ergebnis des Get-PSSessionConfiguration Befehls, der die Konfiguration der eingeschränkten 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 Get-PSSessionConfiguration Cmdlet, 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, sofern vorhanden.

Wenn der Wert der ConfigFilePath-Eigenschaft aufgefüllt ist (true), ruft der Befehl den ConfigFilePath-Eigenschaftswert ab (druckt). Anschließend wird das Test-PSSessionConfigurationFile Cmdlet verwendet, um die Datei im ConfigFilePath-Wert zu testen. Der Verbose-Parameter 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. Wild Karte Zeichen werden unterstützt, müssen jedoch in eine einzelne Datei aufgelöst werden. Sie können auch einen Pfad für die Sitzungskonfigurationsdatei an Test-PSSessionConfigurationFile.

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

Eingaben

String

Sie können einen Sitzungskonfigurationsdateipfad an dieses Cmdlet weiterleiten.

Ausgaben

Boolean

Hinweise

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