Dela via

Test-PSSessionConfigurationFile

  • Referens
Modul:
Microsoft.PowerShell.Core

Verifierar nycklar och värden i en sessionskonfigurationsfil.

Syntax

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

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Den här cmdleten verifierar att en sessionskonfigurationsfil innehåller giltiga nycklar och att värdena är av rätt typ. För uppräknade värden verifierar cmdleten att de angivna värdena är giltiga.

Cmdleten returnerar $True om filen klarar alla tester och $False om den inte gör det. Om du vill hitta fel använder du parametern Utförlig.

Test-PSSessionConfigurationFile verifierar sessionskonfigurationsfilerna, till exempel de som skapats av cmdleten New-PSSessionConfigurationFile. Information om sessionskonfigurationer finns i about_Session_Configurations. Information om sessionskonfigurationsfiler finns i about_Session_Configuration_Files.

Den här cmdleten introducerades i PowerShell 3.0.

Exempel

Exempel 1: Testa en sessionskonfigurationsfil

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Exempel 2: Testa sessionskonfigurationsfilen för en sessionskonfiguration

I det här exemplet testar vi konfigurationsfilen som används i begränsad sessionskonfiguration. Värdet för parametern Path är resultatet av kommandot Get-PSSessionConfiguration som hämtar begränsad sessionskonfiguration. Sökvägen till sessionskonfigurationsfilen lagras i värdet för egenskapen ConfigFilePath för sessionskonfigurationen.

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

Exempel 3: Testa alla sessionskonfigurationsfiler

Funktionen i det här exemplet testar alla sessionskonfigurationsfiler på den lokala datorn. Funktionen använder cmdleten Get-PSSessionConfiguration för att hämta alla sessionskonfigurationer. Koden i ForEach-Object-loopen visar filsökvägen och testar var och en av sessionskonfigurationerna.

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

Egenskapen ConfigFilePath för en sessionskonfiguration innehåller sökvägen till den sessionskonfigurationsfil som används i sessionskonfigurationen.

Om värdet för egenskapen ConfigFilePath är ifyllt (är sant) hämtar kommandot (skriver ut) egenskapsvärdet ConfigFilePath. Sedan använder den cmdleten Test-PSSessionConfigurationFile för att testa filen i värdet ConfigFilePath. Parametern Utförlig returnerar filfelet när filen misslyckas med testet.

Parametrar

-Path

Anger sökvägen och filnamnet för en sessionskonfigurationsfil (.pssc). Om du utelämnar sökvägen är standardinställningen den aktuella mappen. Jokertecken stöds, men de måste matchas till en enda fil. Du kan också skicka en sessionskonfigurationsfilsökväg till Test-PSSessionConfigurationFile.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

Indata

String

Du kan skicka en sessionskonfigurationsfilsökväg till den här cmdleten.

Utdata

Boolean

Kommentarer

Den här cmdleten är endast tillgänglig på Windows-plattformar.