Get-PSSessionConfiguration

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

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

Sözdizimi

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

Description

cmdlet'i Get-PSSessionConfiguration , 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ı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 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ı işleci, tam oturum yapılandırmasını cmdlet'ine Format-List gönderir. Değeri (tümü) olan * Property parametresi, nesnenin tüm özelliklerini ve değerlerini bir listede 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ü, 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 bir Get-PSSessionConfiguration komut 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

Cmdlet, Connect-WSMan Server01 uzak bilgisayarındaki 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 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 nasıl Get-PSSessionConfiguration komut çalıştırılacak 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

cmdlet'iEnable-WSManCredSSP, yerel bilgisayar olan Server01'de CredSSP temsilini etkinleştirir. Cmdlet, Connect-WSMan Server02 bilgisayarına bağlanır. Bu eylem, Server02 için yerel bilgisayardaki WSMan: sürücüsüne bir düğüm ekler ve Server02 bilgisayarında WS-Management ayarlarını görüntülemenize ve değiştirmenize olanak sağlar. 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. Cmdlet, Invoke-Command Server02 bilgisayarında komutunu çalıştırırGet-PSSessionConfiguration . Komutu Credential parametresini kullanır ve CredSSP değeriyle Authentication 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 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 gizler.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String[]
Position:0
Default value:All session configurations on the local computer
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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üren Get-PSSessionConfiguration nesnenin 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.

  • WSMan: sürücüsündeki komutları kullanarak oturum yapılandırmalarının özelliklerini değiştirebilirsiniz. Ancak, PowerShell 3.0'da sunulan 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.