Condividi tramite

Test-PSSessionConfigurationFile

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Verifica le chiavi e i valori in un file di configurazione della sessione.

Sintassi

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

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Questo cmdlet verifica che un file di configurazione della sessione contenga chiavi valide e che i valori siano del tipo corretto. Per i valori enumerati, il cmdlet verifica che i valori specificati siano validi.

Il cmdlet restituisce $True se il file supera tutti i test e $False in caso contrario. Per trovare eventuali errori, usare il parametro dettagliato.

Test-PSSessionConfigurationFile verifica i file di configurazione della sessione, ad esempio quelli creati dal cmdlet New-PSSessionConfigurationFile. Per informazioni sulle configurazioni di sessione, vedere about_Session_Configurations. Per informazioni sui file di configurazione della sessione, vedere about_Session_Configuration_Files.

Questo cmdlet è stato introdotto in PowerShell 3.0.

Esempio

Esempio 1: Testare un file di configurazione di sessione

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Esempio 2: Testare il file di configurazione di una sessione

In questo esempio viene testato il file di configurazione usato nella configurazione della sessione con restrizioni. Il valore del parametro Path è il risultato del comando Get-PSSessionConfiguration che ottiene la configurazione della sessione con restrizioni . Il percorso del file di configurazione della sessione viene archiviato nel valore della proprietà configFilePath della configurazione della sessione.

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

Esempio 3: Testare tutti i file di configurazione della sessione

La funzione in questo esempio testa tutti i file di configurazione della sessione nel computer locale. La funzione usa il cmdlet Get-PSSessionConfiguration per ottenere tutte le configurazioni di sessione. Il codice all'interno del ciclo ForEach-Object visualizza il percorso del file e testa ognuna delle configurazioni di sessione.

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 proprietà ConfigFilePath di una configurazione di sessione contiene il percorso del file di configurazione della sessione utilizzato nella configurazione della sessione, se presente.

Se il valore della proprietà ConfigFilePath è popolato (è true), il comando ottiene (stampa) il valore della proprietà ConfigFilePath. Usa quindi il cmdlet Test-PSSessionConfigurationFile per testare il file nel valore ConfigFilePath. Il parametro Verbose restituisce l'errore del file quando il file non supera il test.

Parametri

-Path

Specifica il percorso e il nome file di un file di configurazione sessione (con estensione pssc). Se si omette il percorso, il valore predefinito è la cartella corrente. I caratteri jolly sono supportati, ma devono essere risolti in un singolo file. È anche possibile inviare tramite pipe un percorso del file di configurazione della sessione a Test-PSSessionConfigurationFile.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

Input

String

È possibile inviare tramite pipe un percorso del file di configurazione della sessione a questo cmdlet.

Output

Boolean

Note

Questo cmdlet è disponibile solo nelle piattaforme Windows.