Get-PSSessionConfiguration

Modül:
Microsoft.PowerShell.Core Module

Bilgisayardaki kayıtlı oturum yapılandırmalarını alır.

Syntax

Default (Varsayılan) 

Get-PSSessionConfiguration
    [[-Name] <String[]>]
    [-Force]
    [<CommonParameters>]

Description

Get-PSSessionConfiguration cmdlet'i, yerel bilgisayarda kayıtlı olan oturum yapılandırmalarını alır. Bu, sistem yöneticileri tarafından kullanıcıları için özelleştirilmiş oturum yapılandırmalarını yönetmek üzere kullanılmak üzere tasarlanmış gelişmiş bir cmdlet'tir.

PowerShell 3.0'da başlayarak, oturum yapılandırması (.pssc) dosyası kullanarak oturum yapılandırmasının özelliklerini tanımlayabilirsiniz. Bu özellik, bilgisayar programı yazmadan özelleştirilmiş ve kısıtlanmış oturumlar oluşturmanıza olanak tanır. Oturum yapılandırma dosyaları hakkında daha fazla bilgi için bkz. about_Session_Configuration_Files.

Ayrıca, PowerShell 3.0'da başlayarak, Get-PSSessionConfiguration döndüren oturum yapılandırma nesnesine yeni not özellikleri eklenmiştir. Bu özellikler, kullanıcıların ve oturum yapılandırma yazarlarının oturum yapılandırmalarını incelemesini ve karşılaştırmasını kolaylaştırır.

Oturum yapılandırması oluşturmak ve kaydetmek için Register-PSSessionConfiguration cmdlet'ini kullanın. Oturum yapılandırmaları hakkında daha fazla bilgi için bkz. about_Session_Configurations.

Örnekler

Örnek 1 - Yerel bilgisayarda oturum yapılandırmalarını alma

Get-PSSessionConfiguration

Örnek 2 - İki varsayılan oturum yapılandırmasını alma

Komut, yalnızca "Microsoft" ile başlayan adlara sahip oturum yapılandırmalarını almak için Get-PSSessionConfiguration parametresini kullanır.

Get-PSSessionConfiguration -Name Microsoft*

Name                      PSVersion  StartupScript        Permission
----                      ---------  -------------        ----------
microsoft.powershell      5.1                             BUILTIN\Administrators AccessAll...
microsoft.powershell32    5.1                             BUILTIN\Administrators AccessAll...

Örnek 3 - Oturum yapılandırmasının özelliklerini ve değerlerini alma

Bu örnekte, oturum yapılandırma dosyası kullanılarak oluşturulan bir oturum yapılandırmasının özellikleri ve özellik değerleri gösterilir.

Get-PSSessionConfiguration -Name Full  | Format-List -Property *

Copyright                     : (c) 2011 User01. All rights reserved.
AliasDefinitions              : {System.Collections.Hashtable}
SessionType                   : Default
CompanyName                   : Unknown
GUID                          : 1e9cb265-dae0-4bd3-89a9-8338a47698a1
Author                        : User01
ExecutionPolicy               : Restricted
SchemaVersion                 : 1.0.0.0
LanguageMode                  : FullLanguage
Architecture                  : 64
Filename                      : %windir%\system32\pwrshplugin.dll
ResourceUri                   : http://schemas.microsoft.com/powershell/Full
MaxConcurrentCommandsPerShell : 1500
UseSharedProcess              : false
ProcessIdleTimeoutSec         : 0
xmlns                         : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
MaxConcurrentUsers            : 10
lang                          : en-US
SupportsOptions               : true
ExactMatch                    : true
configfilepath                : C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Full_1e9cb265-dae0-4bd3-89a9-8338a47698a1.pssc
RunAsUser                     :
IdleTimeoutms                 : 7200000
PSVersion                     : 3.0
OutputBufferingMode           : Block
AutoRestart                   : false
MaxShells                     : 300
MaxMemoryPerShellMB           : 1024
MaxIdleTimeoutMs              : 43200000
SDKVersion                    : 1
Name                          : Full
XmlRenderingType              : text
Capability                    : {Shell}
RunAsPassword                 :
MaxProcessesPerShell          : 25
Enabled                       : True
MaxShellsPerUser              : 30
Permission                    :

Örnek, tüm oturum yapılandırmasını almak için Get-PSSessionConfiguration cmdlet'ini kullanır. İşlem hattı işleci, Tam Oturum Yapılandırmasını Format-List cmdlet'ine gönderir. (tümü) değerine sahip * parametresi, Format-List bir listedeki nesnenin tüm özelliklerini ve değerlerini görüntülemeye yönlendirir.

Çıkış, oturum yapılandırmasının yazarı, oturum türü, dil modu ve bu oturum yapılandırmasıyla oluşturulan oturumların yürütme ilkesi, oturum kotaları ve oturum yapılandırma dosyasının tam yolu gibi yararlı bilgiler içerir.

Oturum yapılandırmasının bu görünümü, oturum yapılandırma dosyası içeren oturumlar için kullanılır. Oturum yapılandırma dosyaları hakkında daha fazla bilgi için bkz. about_Session_Configuration_Files.

Örnek 4 - Oturum yapılandırmalarına bakmanın başka bir yolu

Bu örnek, Eklenti düğümünün içeriğine bakmak için WSMan: sağlayıcı sürücüsündeki Get-ChildItem cmdlet'ini (diğer ad dir) kullanır. Bu, bilgisayardaki oturum yapılandırmalarına bakmanın başka bir yoludur.

dir WSMan:\localhost\plugin

Type            Keys                                Name
----            ----                                ----
Container       {Name=Event Forwarding Plugin}      Event Forwarding Plugin
Container       {Name=Full}                         Full
Container       {Name=microsoft.powershell}         microsoft.powershell
Container       {Name=microsoft.powershell.workf... microsoft.powershell.workflow
Container       {Name=microsoft.powershell32}       microsoft.powershell32
Container       {Name=microsoft.ServerManager}      microsoft.ServerManager
Container       {Name=WMI Provider}                 WMI Provider

PlugIn düğümü, kayıtlı PowerShell oturum yapılandırmalarını temsil eden ContainerElement nesnelerini (Microsoft.WSMan.Management.WSManConfigContainerElement) ve WS-Management için diğer eklentileri içerir.

Örnek 6 - Uzak bilgisayarda oturum yapılandırmalarını görüntüleme

Bu örnekte, uzak bir bilgisayardaki oturum yapılandırmalarını görüntülemek için WSMan sağlayıcısının nasıl kullanılacağı gösterilmektedir. Bu yöntem, Get-PSSessionConfiguration komutu kadar fazla bilgi sağlamaz, ancak kullanıcının bu cmdlet'i çalıştırmak için Administrators grubunun üyesi olması gerekmez.

Connect-WSMan -ComputerName Server01
dir WSMan:\Server01\Plugin

   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Type            Keys                                Name
----            ----                                ----
Container       {Name=Empty}                        Empty
Container       {Name=Event Forwarding Plugin}      Event Forwarding Plugin
Container       {Name=Full}                         Full
Container       {Name=microsoft.powershell}         microsoft.powershell
Container       {Name=microsoft.powershell.workf... microsoft.powershell.workflow
Container       {Name=microsoft.powershell32}       microsoft.powershell32
Container       {Name=microsoft.ServerManager}      microsoft.ServerManager
Container       {Name=NoLanguage}                   NoLanguage
Container       {Name=RestrictedLang}               RestrictedLang
Container       {Name=RRS}                          RRS
Container       {Name=SEL Plugin}                   SEL Plugin
Container       {Name=WithProfile}                  WithProfile
Container       {Name=WMI Provider}                 WMI Provider

Connect-WSMan cmdlet'i, Server01 adlı uzak bilgisayardaki WinRM hizmetine bağlanır. WSMan: sürücüsünün Get-ChildItem cmdlet'i (takma ad dir), Server01\Plugin yolundaki öğeleri alır. Çıktı, Server01 bilgisayarındaki Eklenti dizinindeki öğeleri gösterir. Öğeler, bir tür WSMan eklentisi olan oturum yapılandırmalarını ve bilgisayardaki diğer eklenti türlerini içerir.

Örnek 7 - Uzak bilgisayardan ayrıntılı oturum yapılandırmalarını alma

Bu örnekte, uzak bilgisayarda bir Get-PSSessionConfiguration komutunun nasıl çalıştırılır gösterilmektedir. komutu, yerel bilgisayardaki istemci ayarlarında ve uzak bilgisayardaki hizmet ayarlarında CredSSP temsilinin etkinleştirilmesini gerektirir.

Bu örnekteki komutları çalıştırmak için yerel ve uzak bilgisayarlarda Yöneticiler grubunun üyesi olmanız ve PowerShell'i yönetici olarak çalıştır seçeneğiyle başlatmanız gerekir.

Enable-WSManCredSSP -Delegate Server02
Connect-WSMan Server02
Set-Item WSMan:\Server02*\Service\Auth\CredSSP -Value $true
Invoke-Command -ScriptBlock {Get-PSSessionConfiguration} -ComputerName Server02 -Authentication CredSSP -Credential Domain01\Admin01

Name                      PSVersion  StartupScript        Permission                          PSComputerName
----                      ---------  -------------        ----------                          --------------
microsoft.powershell      5.1                             BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
microsoft.powershell32    5.1                             BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
MyX86Shell                5.1        C:\test\x86Shell.ps1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com

Enable-WSManCredSSP cmdlet'i, yerel bilgisayar olan Server01'de CredSSP temsilini etkinleştirir. Connect-WSMan cmdlet komutu, Server02 bilgisayarına bağlanır. Bu eylem, Server02 için yerel bilgisayardaki WSMan: sürücüsüne bir düğüm ekler ve Sunucu02 bilgisayarındaki WS-Management ayarlarını görüntülemenize ve değiştirmenize olanak sağlar. cmdlet'i, Server02 bilgisayarının Hizmet düğümündeki CredSSP öğesinin değerini Trueolarak değiştirir. Bu, uzak bilgisayardaki hizmet ayarlarını yapılandırıyor. Invoke-Command cmdlet'i Server02 bilgisayarındaGet-PSSessionConfiguration komutunu çalıştırır. komut Kimlik Bilgisi parametresini ve CredSSPdeğeriyle Kimlik Doğrulaması parametresini kullanır. Çıktı, Server02 uzak bilgisayarındaki oturum yapılandırmalarını gösterir.

Örnek 8 - Oturum yapılandırmasının kaynak URI'sini alma

Bu örnek, kaynak URI'sini alan $PSSessionConfigurationName tercih değişkeninin değerini ayarlamak için kullanışlıdır.

(Get-PSSessionConfiguration -Name CustomShell).ResourceUri

http://schemas.microsoft.com/powershell/microsoft.CustomShell

$PSSessionConfigurationName değişkeni, oturum oluşturduğunuzda kullanılan varsayılan yapılandırmayı belirtir. Bu değişken yerel bilgisayarda ayarlanır, ancak uzak bilgisayarda bir yapılandırma belirtir. $PSSessionConfiguration değişkeni hakkında daha fazla bilgi için bkz. about_Preference_Variables.

Parametreler

-Force

Hizmet zaten çalışmıyorsa WinRM hizmetini yeniden başlatma istemini gizler.

Parametre özellikleri

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

Parametre kümeleri

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

-Name

Yalnızca belirtilen ad veya ad düzenine sahip oturum yapılandırmalarını alır. Bir veya daha fazla oturum yapılandırma adı girin. Joker karakterlere izin verilir.

Parametre özellikleri

Tür:

String[]

Default value:All session configurations on the local computer
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
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

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Notlar

  • Bu cmdlet'i çalıştırmak için Yönetici olarak çalıştır seçeneğiyle PowerShell'i başlatın.

  • Bilgisayardaki oturum yapılandırmalarını görüntülemek için bilgisayardaki Administrators grubunun üyesi olmanız gerekir.

  • Uzak bilgisayarda Get-PSSessionConfiguration komutu çalıştırmak için Kimlik Bilgisi Güvenlik Hizmeti Sağlayıcısı (CredSSP) kimlik doğrulamasının yerel bilgisayardaki istemci ayarlarında (Enable-WSManCredSSP cmdlet'i kullanılarak) ve uzak bilgisayardaki hizmet ayarlarında etkinleştirilmesi gerekir. Ayrıca, uzak oturumu oluştururken Kimlik Doğrulaması parametresinin CredSSP değerini kullanmanız gerekir. Aksi takdirde erişim reddedilir.

  • Get-PSSessionConfiguration tarafından döndürülen nesnenin not özellikleri, yalnızca bir değere sahip olduklarında nesne üzerinde görünür. Yalnızca oturum yapılandırma dosyası kullanılarak oluşturulan oturum yapılandırmaları tüm tanımlı özelliklere sahiptir.

  • Oturum yapılandırma nesnesinin özellikleri, oturum yapılandırması için ayarlanan seçeneklere ve bu seçeneklerin değerlerine göre değişir. Ayrıca, oturum yapılandırma dosyası kullanan oturum yapılandırmaları ek özelliklere sahiptir.

  • WSMan: sürücüsündeki komutları kullanarak oturum yapılandırmalarının özelliklerini değiştirebilirsiniz. Ancak, PowerShell 3.0'da tanıtılan OutputBufferingModegibi oturum yapılandırma özelliklerini değiştirmek için PowerShell 2.0'daki WSMan: sürücüsünü kullanamazsınız. PowerShell 2.0 komutları hata oluşturmaz, ancak etkisizdir. PowerShell 3.0'da sunulan özellikleri değiştirmek için PowerShell 3.0'da WSMan: sürücüsünü kullanın.