Bagikan melalui

Test-PSSessionConfigurationFile

Modul:
Microsoft.PowerShell.Core Module

Memverifikasi kunci dan nilai dalam file konfigurasi sesi.

Sintaks

Default (Default) 

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Cmdlet ini memverifikasi bahwa file konfigurasi sesi berisi kunci yang valid dan nilainya adalah jenis yang benar. Untuk nilai enumerasi, cmdlet memverifikasi bahwa nilai yang ditentukan valid.

Cmdlet mengembalikan $true jika file lulus semua pengujian dan $false jika tidak. Untuk menemukan kesalahan apa pun, gunakan parameter Verbose.

Test-PSSessionConfigurationFile memverifikasi file konfigurasi sesi, seperti yang dibuat oleh cmdlet New-PSSessionConfigurationFile. Untuk informasi tentang konfigurasi sesi, lihat about_Session_Configurations. Untuk informasi tentang file konfigurasi sesi, lihat about_Session_Configuration_Files.

Cmdlet ini diperkenalkan di PowerShell 3.0.

Contoh

Contoh 1: Menguji file konfigurasi sesi

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Contoh 2: Menguji file konfigurasi sesi

Dalam contoh ini, kami menguji file konfigurasi yang digunakan dalam konfigurasi sesi terbatas. Nilai parameter Jalur adalah hasil dari perintah Get-PSSessionConfiguration yang mendapatkan konfigurasi sesi Terbatas . Jalur file konfigurasi sesi disimpan dalam nilai properti ConfigFilePath dari konfigurasi sesi.

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

Contoh 3: Menguji semua file konfigurasi sesi

Fungsi dalam contoh ini menguji semua file konfigurasi sesi di komputer lokal. Fungsi ini menggunakan cmdlet Get-PSSessionConfiguration untuk mendapatkan semua konfigurasi sesi. Kode di dalam perulangan ForEach-Object menampilkan jalur file dan menguji setiap konfigurasi sesi.

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

Properti konfigurasi sesi ConfigFilePath berisi jalur file konfigurasi sesi yang digunakan dalam konfigurasi sesi, jika ada.

Jika nilai properti ConfigFilePath terisi (benar), perintah akan mendapatkan (mencetak) nilai properti ConfigFilePath. Kemudian menggunakan cmdlet Test-PSSessionConfigurationFile untuk menguji berkas dalam nilai ConfigFilePath. Parameter Verbose mengembalikan kesalahan file saat file gagal diuji.

Parameter

-Path

Menentukan jalur dan nama file file konfigurasi sesi (.pssc). Jika Anda menghilangkan jalur, defaultnya adalah folder saat ini. Karakter pengganti didukung, tetapi harus mengarah ke satu file. Anda juga dapat menyalurkan jalur file konfigurasi sesi ke Test-PSSessionConfigurationFile.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

(All)
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

Anda dapat menyalurkan jalur file konfigurasi sesi ke cmdlet ini.

Output

Boolean

Catatan

Cmdlet ini hanya tersedia di platform Windows.