Test-PSSessionConfigurationFile

  • Référence
Module:
Microsoft.PowerShell.Core

Vérifie les clés et les valeurs d'un fichier de configuration de session.

Syntax

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

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

Cette applet de commande vérifie qu’un fichier de configuration de session contient des clés valides et que les valeurs sont du type correct. Pour les valeurs énumérées, l'applet de commande vérifie que les valeurs spécifiées sont valides.

L’applet de commande retourne $True si le fichier réussit tous les tests et $False si ce n’est pas le cas. Pour rechercher des erreurs, utilisez le paramètre Verbose .

Test-PSSessionConfigurationFile vérifie les fichiers de configuration de session, tels que ceux créés par l’applet de New-PSSessionConfigurationFile commande. Pour plus d’informations sur les configurations de session, consultez about_Session_Configurations. Pour plus d’informations sur les fichiers de configuration de session, consultez about_Session_Configuration_Files.

Cette applet de commande a été introduite dans PowerShell 3.0.

Exemples

Exemple 1 : Tester un fichier de configuration de session

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Exemple 2 : Tester le fichier de configuration de session d’une configuration de session

Dans cet exemple, nous testons le fichier de configuration utilisé dans la configuration de session restreinte . La valeur du paramètre Path est le résultat de la Get-PSSessionConfiguration commande qui obtient la configuration de session restreinte . Le chemin d’accès du fichier de configuration de session est stocké dans la valeur de la propriété ConfigFilePath de la configuration de session.

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

Exemple 3 : Tester tous les fichiers de configuration de session

La fonction de cet exemple teste tous les fichiers de configuration de session sur l’ordinateur local. La fonction utilise l’applet Get-PSSessionConfiguration de commande pour obtenir toutes les configurations de session. Le code à l’intérieur de la ForEach-Object boucle affiche le chemin du fichier et teste chacune des configurations de session.

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

La propriété ConfigFilePath d’une configuration de session contient le chemin d’accès du fichier de configuration de session utilisé dans la configuration de session, le cas échéant.

Si la valeur de la propriété ConfigFilePath est remplie (est true), la commande obtient (imprime) la valeur de la propriété ConfigFilePath . Ensuite, il utilise l’applet Test-PSSessionConfigurationFile de commande pour tester le fichier dans la valeur ConfigFilePath . Le paramètre Verbose retourne l’erreur de fichier lorsque le fichier échoue au test.

Paramètres

-Path

Spécifie le chemin d’accès et le nom de fichier d’un fichier de configuration de session (.pssc). Si vous omettez le chemin d’accès, la valeur par défaut est le dossier actif. Les caractères génériques carte sont pris en charge, mais ils doivent être résolus en un seul fichier. Vous pouvez également diriger un chemin d’accès au fichier de configuration de session vers Test-PSSessionConfigurationFile.

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

Entrées

String

Vous pouvez diriger un chemin d’accès au fichier de configuration de session vers cette applet de commande.

Sorties

Boolean

Notes

Cette applet de commande est disponible uniquement sur les plateformes Windows.