Test-PSSessionConfigurationFile

Modul:: Microsoft.PowerShell.Core Module

Ellenőrzi a munkamenet-konfigurációs fájl kulcsait és értékeit.

Szintaxis

Default (Alapértelmezett)

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

Leírás

Ez a parancsmag csak a Windows platformon érhető el.

Ez a parancsmag ellenőrzi, hogy egy munkamenet-konfigurációs fájl érvényes kulcsokat tartalmaz-e, és hogy az értékek a megfelelő típusúak-e. A számba vett értékek esetében a parancsmag ellenőrzi, hogy a megadott értékek érvényesek-e.

A parancsmag $true ad vissza, ha a fájl megfelel az összes tesztnek, és $false, ha nem. A hibák kereséséhez használja a Verbose paramétert.

Test-PSSessionConfigurationFile ellenőrzi a munkamenet konfigurációs fájljait, például a New-PSSessionConfigurationFile parancsmag által létrehozott fájlokat. A munkamenet-konfigurációkról további információért lásd a about_Session_Configurations. További információ a munkamenet-konfigurációs fájlokról: about_Session_Configuration_Files.

Ezt a parancsmagot a PowerShell 3.0-ban vezettük be.

Példák

1. példa: Munkamenet-konfigurációs fájl tesztelése

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

2. példa: Egy munkamenet-konfiguráció fájljának tesztelése

Ebben a példában a Korlátozott munkamenet-konfigurációban használt konfigurációs fájlt teszteljük. A Útvonal paraméter értéke annak a Get-PSSessionConfiguration parancsnak az eredménye, amely lekéri a Korlátozott munkamenetkonfigurációt. A munkamenet-konfigurációs fájl elérési útja a munkamenet-konfiguráció ConfigFilePath tulajdonságában van tárolva.

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

3. példa: Az összes munkamenet-konfigurációs fájl tesztelése

A példában szereplő függvény a helyi számítógépen lévő összes munkamenet-konfigurációs fájlt teszteli. A függvény a Get-PSSessionConfiguration parancsmagot használja az összes munkamenet-konfiguráció lekéréséhez. A ForEach-Object ciklusban lévő kód megjeleníti a fájl elérési útját, és teszteli az egyes munkamenet-konfigurációkat.

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

A munkamenet-konfiguráció ConfigFilePath tulajdonsága tartalmazza a munkamenet-konfigurációban használt munkamenet-konfigurációs fájl elérési útját, ha van ilyen.

Ha a ConfigFilePath tulajdonság értéke ki van töltve (igaz), a parancs lekéri (kinyomtatja) a ConfigFilePath tulajdonság értékét. Ezután a Test-PSSessionConfigurationFile parancsmaggal teszteli a fájlt a ConfigFilePath értékben. A Részletes paraméter visszaadja a fájlhibát, ha a fájl nem felel meg a tesztnek.

Paraméterek

-Path

Megadja egy munkamenet-konfigurációs fájl (.pssc) elérési útját és fájlnevét. Ha kihagyja az elérési utat, az alapértelmezett az aktuális mappa. A helyettesítő karakterek támogatottak, de úgy kell őket megoldani, hogy egyetlen fájlra vonatkozzanak. A munkamenet-konfigurációs fájl elérési útját is átirányíthatja a Test-PSSessionConfigurationFileszámára.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogató vadkártyák:	True
Don't Show:	False

Paraméterhalmazok

(All)

Pozíció:	0
Kötelező:	True
Érték a csővezetékből:	True
Érték a csővezetékből az ingatlan név szerint:	True
Érték a maradék argumentumokból:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bemenetek

String

Ehhez a parancsmaghoz egy munkamenet-konfigurációs fájl elérési útját adhatja meg.