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 New-PSSessionConfigurationFile cmdlet. 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 konfigurasi sesi

Dalam contoh ini, kami menguji file konfigurasi yang digunakan dalam konfigurasi sesi Terbatas . Nilai parameter Jalur adalah hasil dari Get-PSSessionConfiguration perintah 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 Get-PSSessionConfiguration cmdlet 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 ConfigFilePath dari konfigurasi sesi berisi jalur file konfigurasi sesi yang digunakan dalam konfigurasi sesi, jika ada.

Jika nilai properti ConfigFilePath diisi (benar), perintah mendapatkan (mencetak) nilai properti ConfigFilePath . Kemudian menggunakan Test-PSSessionConfigurationFile cmdlet untuk menguji file 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 kartubebas didukung, tetapi harus diselesaikan ke satu file. Anda juga dapat menyalurkan jalur file konfigurasi sesi ke Test-PSSessionConfigurationFile.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

Input

String

Anda dapat menyalurkan jalur file konfigurasi sesi ke cmdlet ini.

Output

Boolean

Catatan

Cmdlet ini hanya tersedia di platform Windows.