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 Verbose .

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 konfigurationen för begränsad session. Värdet för parametern Path är resultatet av Get-PSSessionConfiguration kommandot som hämtar konfigurationen för begränsad session. 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 loopen ForEach-Object 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 sessionskonfigurationsfilen som används i sessionskonfigurationen, om någon.

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 Verbose 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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.