Test-PSSessionConfigurationFile

Ellenőrzi a kulcsokat és az értékeket egy munkamenet-konfigurációs fájlban.

Syntax

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

Description

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. Az enumerált értékek esetében a parancsmag ellenőrzi, hogy a megadott értékek érvényesek-e.

A parancsmag akkor ad $True vissza, ha a fájl megfelel az összes tesztnek, és $False ha nem. A hibák kereséséhez használja a Részletes 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ókkal kapcsolatos információkért lásd 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: Munkamenet-konfiguráció munkamenet-konfigurációs 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. Az Elérési út paraméter értéke a Korlátozott munkamenet konfigurációját Get-PSSessionConfiguration lekérő parancs eredménye. A munkamenet-konfigurációs fájl elérési útja a munkamenet-konfiguráció ConfigFilePath tulajdonságának értékében 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 található összes munkamenet-konfigurációs fájlt teszteli. A függvény a parancsmagot használja az Get-PSSessionConfiguration összes munkamenet-konfiguráció lekéréséhez. A hurokban lévő kód megjeleníti a ForEach-Object 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 fel 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 Verbose paraméter akkor adja vissza 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 mappa az aktuális mappa. A helyettesítő karakterek támogatottak, de egyetlen fájlra kell feloldani őket. A munkamenet-konfigurációs fájl elérési útját is átirányíthatja ide Test-PSSessionConfigurationFile.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

Bevitelek

String

A munkamenetkonfigurációs fájl elérési útját átadhatja a fájlnak Test-PSSessionConfigurationFile.

Kimenetek

Boolean

Jegyzetek

Ez a parancsmag csak Windows-platformokon érhető el.