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

Das Cmdlet gibt zurück $True , wenn die Datei alle Tests besteht 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 New-PSSessionConfigurationFile vom Cmdlet erstellten. 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 Eingeschränkten Sitzungskonfiguration verwendet wird. Der Wert des Path-Parameters ist das Ergebnis des Befehls, der Get-PSSessionConfiguration die Eingeschränkte Sitzungskonfiguration 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 jede sitzungskonfiguration.

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 ggf. in der Sitzungskonfiguration verwendet wird.

Wenn der Wert der ConfigFilePath-Eigenschaft angegeben ist (sprich er ist „true“), ruft der Befehl den ConfigFilePath-Eigenschaftswert ab (bzw. gibt ihn aus). Anschließend wird das Test-PSSessionConfigurationFile Cmdlet verwendet, um die Datei im Wert ConfigFilePath zu testen. Der Verbose-Parameter gibt den Dateifehler zurück, wenn die Datei den Test nicht besteht.

Parameter

-Path

Gibt den Pfad und Dateinamen einer Sitzungskonfigurationsdatei (PSSC) an. Wenn Sie den Pfad weglassen, ist der Standardwert der aktuelle Ordner. Feldhalterzeichen werden unterstützt, müssen jedoch in eine einzelne Datei aufgelöst werden. Sie können auch einen Pfad der Sitzungskonfigurationsdatei an übergeben 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 Pfad der Sitzungskonfigurationsdatei an übergeben Test-PSSessionConfigurationFile.

Ausgaben

Boolean

Hinweise

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