Test-PSSessionConfigurationFile

Modul:: Microsoft.PowerShell.Core Module

Verifierar nycklar och värden i en sessionskonfigurationsfil.

Syntax

Default (Standard)

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. Använd parametern Utförlig för att hitta eventuella fel.

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 konfigurationen, om sådan finns.

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 resultera i en enda fil. Du kan också skicka en sessionskonfigurationsfilsökväg till Test-PSSessionConfigurationFile.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	True
DontShow:	False

Parameteruppsättningar

(All)

Position:	0
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Du kan skicka en sökväg till en sessionskonfigurationsfil till den här cmdlet.