Aracılığıyla paylaş

Test-PSSessionConfigurationFile

Modül:
Microsoft.PowerShell.Core Module

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

Sözdizimi

Default EnterprisePublishing 

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 $true döndürür ve geçirilmezse $false. Hataları bulmak için Ayrıntılı parametresini kullanın.

Test-PSSessionConfigurationFile, New-PSSessionConfigurationFile cmdlet'i tarafından 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: Bir oturum yapılandırmasının oturum yapılandırma dosyasını test edin

Bu örnekte, Kısıtlı oturumu yapılandırmasında kullanılan yapılandırma dosyasını test ediyoruz. Yolu parametresinin değeri, Get-PSSessionConfiguration oturum yapılandırmasını elde eden komutunun sonucudur. 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. İşlev, tüm oturum yapılandırmalarını almak için Get-PSSessionConfiguration cmdlet'ini kullanır. ForEach-Object döngüsünün 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 Test-PSSessionConfigurationFile değerindeki dosyayı test etmek için cmdlet'ini kullanır. Dosya testi başarısız olduğunda Ayrıntılı parametresi 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. Oturum yapılandırma dosyası yolunu Test-PSSessionConfigurationFile'e de pipelayabilirsiniz.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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.