Test-PSSessionConfigurationFile
Ü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. Wildcardzeichen 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
.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | True |
Eingaben
Sie können einen Sitzungskonfigurationsdateipfad an dieses Cmdlet weiterleiten.
Ausgaben
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Ähnliche Themen
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan-Anbieter
- about_Session_Configurations
- about_Session_Configuration_Files