Test-PSSessionConfigurationFile

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Verifica le chiavi e valori in un file di configurazione di 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 Verbose .

Test-PSSessionConfigurationFile verifica i file di configurazione della sessione, ad esempio quelli creati dal New-PSSessionConfigurationFile cmdlet . 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 della sessione di una configurazione di 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 Get-PSSessionConfiguration comando 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 Get-PSSessionConfiguration cmdlet per ottenere tutte le configurazioni di sessione. Il codice all'interno del ForEach-Object ciclo 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 di sessione, se presente.

Se il valore della proprietà ConfigFilePath viene popolato (è true), il comando ottiene (stampa) il valore della proprietà ConfigFilePath . Usa quindi il Test-PSSessionConfigurationFile cmdlet per testare il file nel valore ConfigFilePath . Il parametro Verbose restituisce l'errore del file quando il file non riesce 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.

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