Test-PSSessionConfigurationFile

  • Referencia
Módulo:
Microsoft.PowerShell.Core

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

Syntax

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. En relación con 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 Verbose .

Test-PSSessionConfigurationFile comprueba los archivos de configuración de sesión, como los creados por el New-PSSessionConfigurationFile cmdlet . 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, consulte 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 sesión restringida . El valor del parámetro Path es el resultado del Get-PSSessionConfiguration comando que obtiene la configuración de sesión restringida . La ruta de acceso del archivo de configuración de sesión se almacena en el valor de la propiedad ConfigFilePath 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 Get-PSSessionConfiguration cmdlet para obtener todas las configuraciones de sesión. El código dentro del ForEach-Object bucle 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 Test-PSSessionConfigurationFile cmdlet para probar el archivo en el valor 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.

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