Get-PSSessionConfiguration

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

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

Syntax

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

Description

Get-PSSessionConfiguration Cmdlet, 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, döndüren Get-PSSessionConfiguration oturum yapılandırma nesnesine yeni not özellikleri eklenmiştir. Bu özellikler, kullanıcıların ve oturum yapılandırması 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 cmdlet'ini Register-PSSessionConfiguration kullanın. Oturum yapılandırmaları hakkında daha fazla bilgi edinmek 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

Komutu, yalnızca "Microsoft" ile başlayan adlara sahip oturum yapılandırmalarını almak için Name parametresini Get-PSSessionConfiguration 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, tam oturum yapılandırmasını almak için cmdlet'ini kullanır Get-PSSessionConfiguration . İşlem hattı operatörü, cmdlet'ine Format-List Tam oturum yapılandırmasını gönderir. (tümü) değerine * sahip Property parametresi, bir listedeki nesnenin tüm özelliklerini ve değerlerini görüntülemeye yönlendirirFormat-List.

Çı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 Get-ChildItem içeriğine bakmak için WSMan: sağlayıcı sürücüsündeki 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ü ContainerElement nesneleri (Microsoft içerir. WS-Management için diğer eklentilerle birlikte kayıtlı PowerShell oturum yapılandırmalarını temsil eden WSMan.Management.WSManConfigContainerElement).

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

Bu örnekte, uzak 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 komut Get-PSSessionConfiguration kadar fazla bilgi sağlamaz, ancak kullanıcının bu cmdlet'i çalıştırmak için Yöneticiler 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

Cmdlet, Connect-WSMan Server01 uzak bilgisayardaki WinRM hizmetine bağlanır. Get-ChildItem WSMan: sürücüsünün cmdlet'i (diğer addir), Server01\Plugin yolundaki öğeleri alır. Çıktı, Server01 bilgisayarındaki Eklenti dizinindeki öğeleri gösterir. Öğeler, bir WSMan eklentisi türü 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 komutun nasıl çalıştırılacakları gösterilmektedir. komutu, CredSSP temsilcisinin yerel bilgisayardaki istemci ayarlarında ve uzak bilgisayardaki hizmet ayarlarında 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

cmdlet'i Enable-WSManCredSSP , yerel bilgisayar olan Server01'de CredSSP temsilcisini etkinleştirir. Cmdlet Server02 Connect-WSMan bilgisayarına bağlanır. Bu eylem, Yerel bilgisayardaki WSMan: sürücüsüne Server02 için bir düğüm ekler ve Böylece Server02 bilgisayarındaki WS-Management ayarlarını görüntüleyebilir ve değiştirebilirsiniz. Cmdlet, Set-Item Server02 bilgisayarının Hizmet düğümündeki CredSSP öğesinin değerini True olarak değiştirir. Bu, uzak bilgisayardaki hizmet ayarlarını yapılandırıyor. Invoke-Command Cmdlet, Server02 bilgisayarında komutunu çalıştırırGet-PSSessionConfiguration. Komutu Credential parametresini, Authentication parametresini ise CredSSP değeriyle kullanır. Çıkış, Server02 uzak bilgisayardaki oturum yapılandırmalarını gösterir.

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

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

(Get-PSSessionConfiguration -Name CustomShell).resourceURI

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

değişkeni, $PSSessionConfigurationName 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. Değişken hakkında $PSSessionConfiguration daha fazla bilgi için bkz. about_Preference_Variables.

Parametreler

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:All session configurations on the local computer
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Notlar

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

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

  • Uzak bilgisayarda bir Get-PSSessionConfiguration komut ç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 (cmdlet kullanılarak Enable-WSManCredSSP ) ve uzak bilgisayardaki hizmet ayarlarında etkinleştirilmesi gerekir. Ayrıca, uzak oturumu oluştururken Authentication parametresinin CredSSP değerini kullanmanız gerekir. Aksi takdirde erişim reddedilir.

  • Döndürülen nesnenin Get-PSSessionConfiguration not özellikleri, nesnede yalnızca bir değere sahip olduklarında 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.

  • Oturum yapılandırmalarının özelliklerini değiştirmek için WSMan: sürücüsündeki komutları kullanabilirsiniz. Ancak, PowerShell 3.0'da tanıtılan OutputBufferingMode gibi 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.