Aracılığıyla paylaş

Test-PSSessionConfigurationFile

  • Başvuru
Modül:
Microsoft.PowerShell.Core

Oturum yapılandırma dosyasındaki anahtarları ve değerleri doğrular.

Sözdizimi

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Bu cmdlet, oturum yapılandırma dosyasının geçerli anahtarlar içerdiğini ve değerlerin doğru türde olduğunu doğrular. Numaralandırılmış değerler için, cmdlet belirtilen değerlerin geçerli olduğunu doğrular.

Cmdlet, dosya tüm testleri geçerse ve $False geçirilmezse döndürür$True. Hataları bulmak için Ayrıntılı parametresini kullanın.

Test-PSSessionConfigurationFile cmdlet'i tarafından New-PSSessionConfigurationFile oluşturulanlar gibi oturum yapılandırma dosyalarını doğrular. Oturum yapılandırmaları hakkında bilgi için bkz . about_Session_Configurations. Oturum yapılandırma dosyaları hakkında bilgi için bkz . about_Session_Configuration_Files.

Bu cmdlet PowerShell 3.0'da kullanıma sunulmuştur.

Örnekler

Örnek 1: Oturum yapılandırma dosyasını test edin

Test-PSSessionConfigurationFile -Path "FullLanguage.pssc"

True

Örnek 2: Oturum yapılandırmasının oturum yapılandırma dosyasını test edin

Bu örnekte, Kısıtlı oturum yapılandırmasında kullanılan yapılandırma dosyasını test ediyoruz. Path parametresinin değeri, Kısıtlı oturum yapılandırmasını alan komutun sonucudurGet-PSSessionConfiguration. Oturum yapılandırma dosyasının yolu, oturum yapılandırmasının ConfigFilePath özelliğinin değerinde depolanır.

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

Örnek 3: Tüm oturum yapılandırma dosyalarını test edin

Bu örnekteki işlev, yerel bilgisayardaki tüm oturum yapılandırma dosyalarını test ediyor. işlevi, tüm oturum yapılandırmalarını almak için cmdlet'ini kullanır Get-PSSessionConfiguration . Döngünün ForEach-Object içindeki kod dosya yolunu görüntüler ve oturum yapılandırmalarının her birini test eder.

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

Bir oturum yapılandırmasının ConfigFilePath özelliği, varsa oturum yapılandırmasında kullanılan oturum yapılandırma dosyasının yolunu içerir.

ConfigFilePath özelliğinin değeri doldurulmuşsa (true ise), komut ConfigFilePath özellik değerini alır (yazdırır). Ardından ConfigFilePath değerindeki dosyayı test etmek için cmdlet'ini kullanırTest-PSSessionConfigurationFile. Ayrıntılı parametresi, dosya testte başarısız olduğunda dosya hatasını döndürür.

Parametreler

-Path

Oturum yapılandırma dosyasının (.pssc) yolunu ve dosya adını belirtir. Yolu atlarsanız varsayılan olarak geçerli klasör kullanılır. Joker karakterler desteklenir, ancak tek bir dosyaya çözümlenmeleri gerekir. Ayrıca bir oturum yapılandırma dosyası yolunu adresine de aktarabilirsiniz Test-PSSessionConfigurationFile.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:True

Girişler

String

Oturum yapılandırma dosyası yolunu bu cmdlet'e aktarabilirsiniz.

Çıkışlar

Boolean

Notlar

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.