Get-PSSessionConfiguration

  • Referensi
Modul:
Microsoft.PowerShell.Core

Mendapatkan konfigurasi sesi terdaftar di komputer.

Sintaks

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

Deskripsi

Get-PSSessionConfiguration Cmdlet mendapatkan konfigurasi sesi yang telah didaftarkan di komputer lokal. Ini adalah cmdlet tingkat lanjut yang dirancang untuk digunakan oleh administrator sistem untuk mengelola konfigurasi sesi yang disesuaikan untuk pengguna mereka.

Dimulai di PowerShell 3.0, Anda dapat menentukan properti konfigurasi sesi dengan menggunakan file konfigurasi sesi (.pssc). Fitur ini memungkinkan Anda membuat sesi yang disesuaikan dan dibatasi tanpa menulis program komputer. Untuk informasi selengkapnya tentang file konfigurasi sesi, lihat about_Session_Configuration_Files.

Selain itu, dimulai di PowerShell 3.0, properti catatan baru telah ditambahkan ke objek konfigurasi sesi yang Get-PSSessionConfiguration kembali. Properti ini memudahkan pengguna dan penulis konfigurasi sesi untuk memeriksa dan membandingkan konfigurasi sesi.

Untuk membuat dan mendaftarkan konfigurasi sesi, gunakan Register-PSSessionConfiguration cmdlet. Untuk informasi selengkapnya tentang konfigurasi sesi, lihat about_Session_Configurations.

Contoh

Contoh 1 - Mendapatkan konfigurasi sesi di komputer lokal

Get-PSSessionConfiguration

Contoh 2 - Dapatkan dua konfigurasi sesi default

Perintah menggunakan parameter Get-PSSessionConfiguration Nama untuk mendapatkan hanya konfigurasi sesi dengan nama yang dimulai dengan "Microsoft".

Get-PSSessionConfiguration -Name Microsoft*

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

Contoh 3 - Mendapatkan properti dan nilai konfigurasi sesi

Contoh ini memperlihatkan properti dan nilai properti konfigurasi sesi yang dibuat dengan menggunakan file konfigurasi sesi.

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                    :

Contohnya menggunakan Get-PSSessionConfiguration cmdlet untuk mendapatkan konfigurasi sesi penuh. Operator alur mengirimkan konfigurasi Sesi penuh ke Format-List cmdlet. Parameter Properti dengan nilai * (semua) mengarahkan Format-List untuk menampilkan semua properti dan nilai objek dalam daftar.

Output mencakup informasi yang berguna, termasuk penulis konfigurasi sesi, jenis sesi, mode bahasa, dan kebijakan eksekusi sesi yang dibuat dengan konfigurasi sesi ini, kuota sesi, dan jalur lengkap ke file konfigurasi sesi.

Tampilan konfigurasi sesi ini digunakan untuk sesi yang menyertakan file konfigurasi sesi. Untuk informasi selengkapnya tentang file konfigurasi sesi, lihat about_Session_Configuration_Files.

Contoh 4 - Cara lain untuk melihat konfigurasi sesi

Contoh ini menggunakan Get-ChildItem cmdlet (alias dir) di drive penyedia WSMan: untuk melihat konten simpul Plugin. Ini adalah cara lain untuk melihat konfigurasi sesi di komputer.

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

Simpul PlugIn berisi objek ContainerElement (Microsoft.WSMan.Management.WSManConfigContainerElement) yang mewakili konfigurasi sesi PowerShell terdaftar, bersama dengan plug-in lainnya untuk WS-Management.

Contoh 6 - Melihat konfigurasi sesi di komputer jarak jauh

Contoh ini menunjukkan cara menggunakan penyedia WSMan untuk melihat konfigurasi sesi di komputer jarak jauh. Metode ini tidak memberikan informasi Get-PSSessionConfiguration sebanyak perintah, tetapi pengguna tidak perlu menjadi anggota grup Administrator untuk menjalankan cmdlet ini.

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 tersambung ke layanan WinRM di komputer jarak jauh Server01. Get-ChildItem Cmdlet (alias dir) dari WSMan: drive mendapatkan item di jalur Server01\Plugin. Output menunjukkan item di direktori Plugin di komputer Server01. Item termasuk konfigurasi sesi, yang merupakan jenis plug-in WSMan, bersama dengan jenis plug-in lain di komputer.

Contoh 7 - Dapatkan konfigurasi sesi terperinci dari komputer jarak jauh

Contoh ini menunjukkan cara menjalankan Get-PSSessionConfiguration perintah di komputer jarak jauh. Perintah mengharuskan delegasi CredSSP diaktifkan dalam pengaturan klien pada komputer lokal dan dalam pengaturan layanan di komputer jarak jauh.

Untuk menjalankan perintah dalam contoh ini, Anda harus menjadi anggota grup Administrator di komputer lokal dan jarak jauh dan Anda harus memulai PowerShell dengan opsi Jalankan sebagai administrator .

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 memungkinkan delegasi CredSSP di Server01, komputer lokal. Connect-WSMan Cmdlet tersambung ke komputer Server02. Tindakan ini menambahkan simpul untuk Server02 ke WSMan: drive di komputer lokal, memungkinkan Anda melihat dan mengubah pengaturan WS-Management pada komputer Server02. Set-Item Cmdlet mengubah nilai item CredSSP di node Layanan komputer Server02 menjadi True. Ini mengonfigurasi pengaturan layanan pada komputer jarak jauh. Invoke-Command Cmdlet menjalankanGet-PSSessionConfiguration perintah pada komputer Server02. Perintah menggunakan parameter Kredensial , dan menggunakan parameter Autentikasi dengan nilai CredSSP. Output menunjukkan konfigurasi sesi pada komputer jarak jauh Server02.

Contoh 8 - Mendapatkan URI sumber daya konfigurasi sesi

Contoh ini berguna untuk mengatur nilai $PSSessionConfigurationName variabel preferensi, yang mengambil URI sumber daya.

(Get-PSSessionConfiguration -Name CustomShell).resourceURI

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

Variabel $PSSessionConfigurationName menentukan konfigurasi default yang digunakan saat Anda membuat sesi. Variabel ini diatur pada komputer lokal, tetapi menentukan konfigurasi pada komputer jarak jauh. Untuk informasi selengkapnya tentang variabel, $PSSessionConfiguration lihat about_Preference_Variables.

Parameter

-Force

Menekan perintah untuk memulai ulang layanan WinRM, jika layanan belum berjalan.

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

-Name

Hanya mendapatkan konfigurasi sesi dengan nama atau pola nama yang ditentukan. Masukkan satu atau beberapa nama konfigurasi sesi. Kartubebas diizinkan.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Catatan

  • Untuk menjalankan cmdlet ini, mulai PowerShell dengan opsi Jalankan sebagai administrator .

  • Untuk melihat konfigurasi sesi di komputer, Anda harus menjadi anggota grup Administrator di komputer.

  • Untuk menjalankan Get-PSSessionConfiguration perintah pada komputer jarak jauh, autentikasi Penyedia Layanan Keamanan Kredensial (CredSSP) harus diaktifkan dalam pengaturan klien pada komputer lokal (dengan menggunakan Enable-WSManCredSSP cmdlet) dan dalam pengaturan layanan pada komputer jarak jauh. Selain itu , Anda harus menggunakan nilai CredSSP dari parameter Autentikasi saat membuat sesi jarak jauh. Jika tidak, akses ditolak.

  • Properti catatan objek yang Get-PSSessionConfiguration kembali muncul pada objek hanya ketika mereka memiliki nilai. Hanya konfigurasi sesi yang dibuat dengan menggunakan file konfigurasi sesi yang memiliki semua properti yang ditentukan.

  • Properti objek konfigurasi sesi bervariasi menurut opsi yang diatur untuk konfigurasi sesi dan nilai opsi tersebut. Selain itu, konfigurasi sesi yang menggunakan file konfigurasi sesi memiliki properti tambahan.

  • Anda dapat menggunakan perintah di drive WSMan: untuk mengubah properti konfigurasi sesi. Namun, Anda tidak dapat menggunakan drive WSMan: di PowerShell 2.0 untuk mengubah properti konfigurasi sesi yang diperkenalkan di PowerShell 3.0, seperti OutputBufferingMode. Perintah PowerShell 2.0 tidak menghasilkan kesalahan, tetapi tidak efektif. Untuk mengubah properti yang diperkenalkan di PowerShell 3.0, gunakan WSMan: drive di PowerShell 3.0.