Compartir a través de

Test-PSSessionConfigurationFile

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Comprueba las claves y los valores de un archivo de configuración de sesión.

Sintaxis

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

Este cmdlet comprueba que un archivo de configuración de sesión contiene claves válidas y los valores son del tipo correcto. Para los valores enumerados, el cmdlet comprueba que los valores especificados son válidos.

El cmdlet devuelve $True si el archivo supera todas las pruebas y $False si no lo hace. Para buscar errores, use el parámetro Detallado.

Test-PSSessionConfigurationFile comprueba los archivos de configuración de sesión, como los creados por el cmdlet New-PSSessionConfigurationFile. Para obtener información sobre las configuraciones de sesión, consulte about_Session_Configurations. Para obtener información sobre los archivos de configuración de sesión, vea about_Session_Configuration_Files.

Este cmdlet se introdujo en PowerShell 3.0.

Ejemplos

Ejemplo 1: Probar un archivo de configuración de sesión

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Ejemplo 2: Probar el archivo de configuración de sesión de una configuración de sesión

En este ejemplo, se prueba el archivo de configuración usado en la configuración de Restricted sesión. El valor del parámetro Path es el resultado del comando Get-PSSessionConfiguration que obtiene la configuración de sesión de restringido de. La ruta de acceso del archivo de configuración de sesión se almacena en el valor de la ConfigFilePath propiedad de la configuración de sesión.

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

Ejemplo 3: Probar todos los archivos de configuración de sesión

La función de este ejemplo prueba todos los archivos de configuración de sesión en el equipo local. La función usa el cmdlet Get-PSSessionConfiguration para obtener todas las configuraciones de sesión. El código dentro del bucle ForEach-Object muestra la ruta de acceso del archivo y prueba cada una de las configuraciones de sesión.

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 propiedad ConfigFilePath de una configuración de sesión contiene la ruta de acceso del archivo de configuración de sesión que se usa en la configuración de sesión, si existe.

Si el valor de la propiedad ConfigFilePath se rellena (es true), el comando obtiene (imprime) el valor de la propiedad ConfigFilePath. A continuación, usa el cmdlet Test-PSSessionConfigurationFile para probar el archivo en el valor de ConfigFilePath. El parámetro verbose devuelve el error de archivo cuando se produce un error en la prueba.

Parámetros

-Path

Especifica la ruta de acceso y el nombre de archivo de configuración de una sesión (.pssc). Si omite la ruta de acceso, el valor predeterminado es la carpeta actual. Se admiten caracteres comodín, pero deben resolverse en un solo archivo. También puede canalizar una ruta de acceso del archivo de configuración de sesión a Test-PSSessionConfigurationFile.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

Entradas

String

Puede canalizar una ruta de acceso del archivo de configuración de sesión a este cmdlet.

Salidas

Boolean

Notas

Este cmdlet solo está disponible en plataformas Windows.