Test-PSSessionConfigurationFile

Referensi

Modul:: Microsoft.PowerShell.Core

Memverifikasi kunci dan nilai dalam file konfigurasi sesi.

Sintaks

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.

Jenis:	String
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	True

Input

String

Anda dapat menyalurkan jalur file konfigurasi sesi ke cmdlet ini.

Output

Boolean

Catatan

Cmdlet ini hanya tersedia di platform Windows.

Bagikan melalui