Bagikan melalui

Get-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Mengambil konfigurasi sesi yang terdaftar di komputer.

Sintaks

Default (Default) 

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

Deskripsi

cmdlet Get-PSSessionConfiguration 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 dengan PowerShell 3.0, properti catatan baru telah ditambahkan ke objek konfigurasi sesi yang dikembalikan oleh Get-PSSessionConfiguration. Properti ini memudahkan pengguna dan penulis konfigurasi sesi untuk memeriksa dan membandingkan konfigurasi sesi.

Untuk membuat dan mendaftarkan konfigurasi sesi, gunakan cmdlet Register-PSSessionConfiguration. 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 bawaan

Perintah ini menggunakan parameter NamaGet-PSSessionConfiguration 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 cmdlet Get-PSSessionConfiguration untuk mendapatkan konfigurasi sesi penuh. Operator pipeline mengirimkan konfigurasi sesi lengkap ke cmdlet Format-List. 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 cmdlet Get-ChildItem (alias dir) di drive WSMan: penyedia 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 yang terdaftar, serta plug-in lain 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 sebanyak perintah Get-PSSessionConfiguration, 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

Cmdlet Connect-WSMan tersambung ke layanan WinRM di komputer jarak jauh Server01. Cmdlet Get-ChildItem (alias dir) dari WSMan: drive mendapatkan item di jalur Server01\Plugin. Hasil keluaran menunjukkan item di direktori Plugin di komputer Server01. Item-item tersebut termasuk konfigurasi sesi, yang merupakan jenis plug-in WSMan, bersama dengan jenis plug-in lainnya di komputer.

Contoh 7 - Dapatkan konfigurasi sesi terperinci dari komputer jarak jauh

Contoh ini menunjukkan cara menjalankan perintah Get-PSSessionConfiguration 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

Cmdlet Enable-WSManCredSSP mengaktifkan delegasi CredSSP pada komputer lokal, Server01. Cmdlet Connect-WSMan tersambung ke komputer Server02. Tindakan ini menambahkan simpul untuk Server02 ke drive WSMan: pada komputer lokal, memungkinkan Anda melihat dan mengubah pengaturan WS-Management di komputer Server02. Cmdlet Set-Item mengubah nilai item CredSSP di node Layanan komputer Server02 menjadi True. Ini mengonfigurasi pengaturan layanan pada komputer jarak jauh. Cmdlet Invoke-Command menjalankan perintahGet-PSSessionConfiguration pada komputer Server02. Perintah ini menggunakan parameter Kredensial, dan menggunakan parameter Autentikasi dengan nilai CredSSP. Output menunjukkan konfigurasi sesi pada komputer remote Server02.

Contoh 8 - Mendapatkan URI sumber daya konfigurasi sesi

Contoh ini berguna untuk mengatur nilai variabel preferensi $PSSessionConfigurationName, 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 pemberitahuan untuk memulai ulang layanan WinRM, jika layanan tersebut belum aktif.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

Mengambil hanya konfigurasi sesi dengan nama atau pola nama yang ditentukan. Masukkan satu atau beberapa nama konfigurasi sesi. Kartu liar diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:All session configurations on the local computer
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

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 perintah Get-PSSessionConfiguration pada komputer jarak jauh, autentikasi Penyedia Layanan Keamanan Kredensial (CredSSP) harus diaktifkan dalam pengaturan klien pada komputer lokal (dengan menggunakan cmdlet Enable-WSManCredSSP) 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 dari objek yang dikembalikan oleh Get-PSSessionConfiguration hanya muncul pada objek ketika properti-properti tersebut 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.