Get-PSSessionConfiguration
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.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Name
Hanya mendapatkan konfigurasi sesi dengan nama atau pola nama yang ditentukan. Masukkan satu atau beberapa nama konfigurasi sesi. Kartubebas diizinkan.
Jenis: | String[] |
Position: | 0 |
Nilai default: | All session configurations on the local computer |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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 menggunakanEnable-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.
Link Terkait
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- Penyedia WSMan
- about_Session_Configurations
- about_Session_Configuration_Files