Set-PSSessionConfiguration

Modul:

Microsoft.PowerShell.Core Module

Mengubah properti konfigurasi sesi terdaftar.

Sintaks

NameParameterSet (Default)

Set-PSSessionConfiguration
    [-Name] <String>
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AssemblyNameParameterSet

Set-PSSessionConfiguration
    [-Name] <String>
    [-AssemblyName] <String>
    [-ConfigurationTypeName] <String>
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SessionConfigurationFile

Set-PSSessionConfiguration
    [-Name] <String>
    -Path <String>
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-TransportOption <PSTransportOption>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

cmdlet Set-PSSessionConfiguration mengubah properti konfigurasi sesi di komputer lokal.

Gunakan parameter Nama untuk mengidentifikasi konfigurasi sesi yang ingin Anda ubah. Gunakan parameter lain untuk menentukan nilai baru untuk properti konfigurasi sesi. Untuk menghapus nilai properti dari konfigurasi, dan menggunakan nilai default, masukkan string kosong ("") atau nilai $null untuk parameter yang sesuai.

Mulai dari PowerShell 3.0, Anda dapat menggunakan file konfigurasi sesi untuk menentukan konfigurasi sesi. Fitur ini menyediakan metode sederhana dan dapat ditemukan untuk mengatur dan mengubah properti sesi yang menggunakan konfigurasi sesi. Untuk menentukan file konfigurasi sesi, gunakan parameter Jalur dari . Untuk informasi tentang file konfigurasi sesi, lihat about_Session_Configuration_Files. Untuk informasi tentang cara membuat dan memodifikasi file konfigurasi sesi, lihat cmdlet New-PSSessionConfigurationFile.

Konfigurasi sesi menentukan lingkungan sesi jarak jauh (PSSessions) yang terhubung ke komputer lokal. Setiap PSSession menggunakan konfigurasi sesi. Konfigurasi sesi menentukan fiturPSSession , seperti modul yang tersedia dalam sesi, cmdlet yang diizinkan untuk dijalankan, mode bahasa, kuota, dan batas waktu. Pendeskripsi keamanan konfigurasi sesi menentukan siapa yang dapat menggunakan konfigurasi sesi untuk menyambungkan ke komputer lokal. Untuk informasi selengkapnya tentang konfigurasi sesi, lihat about_Session_Configurations.

Untuk melihat properti konfigurasi sesi, gunakan cmdlet Get-PSSessionConfiguration atau Penyedia WSMan. Untuk informasi selengkapnya tentang Penyedia WSMan, ketik Get-Help WSMan.

Contoh

Contoh 1: Membuat dan mengubah konfigurasi sesi

Contoh ini menunjukkan cara menambahkan dan menghapus skrip startup dari konfigurasi.

Perintah pertama membuat konfigurasi AdminShell. Perintah kedua menambahkan skrip AdminConfig.ps1 ke konfigurasi. Perubahan ini efektif ketika Anda memulai ulang WinRM. Perintah ketiga menghapus skrip AdminConfig.ps1 dari konfigurasi.

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $null

Contoh 2: Menampilkan hasil

Contoh ini meningkatkan nilai properti MaximumReceivedObjectSizeMB menjadi 20. Perintah ini juga meminta Anda untuk memulai ulang layanan WinRM. Perubahan tidak efektif sampai layanan WinRM dimulai ulang.

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\IncObj\InitializationParameters

ParamName                       ParamValue
---------                       ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "Restart-Service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Contoh 3: Menampilkan hasil dengan cara yang berbeda

Dalam contoh ini, mengubah skrip startup di konfigurasi sesi MaintenanceShell menjadi . Output menunjukkan perubahan dan meminta Anda untuk memulai ulang layanan WinRM. Responsnya y (ya).

mendapatkan konfigurasi sesi MaintenanceShell. Operator alur (|) mengirim hasil perintah ke Format-List, yang menampilkan semua properti objek konfigurasi dalam daftar. Selanjutnya, menggunakan penyedia WSMan, kami melihat parameter inisialisasi untuk konfigurasi MaintenanceShell. Get-ChildItem mendapatkan item anak di node InitializationParameters untuk plug-in MaintenanceShell. Untuk informasi selengkapnya tentang penyedia WSMan, ketik Get-Help WSMan.

Set-PSSessionConfiguration -Name "MaintenanceShell" -StartupScript "C:\ps-test\Maintenance.ps1"

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName            ParamValue
---------            ----------
startupscript        C:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run
the command "Restart-Service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name             : MaintenanceShell
Filename         : %windir%\system32\pwrshplugin.dll
SDKVersion       : 1
XmlRenderingType : text
lang             : en-US
PSVersion        : 2.0
startupscript    : C:\ps-test\Maintenance.ps1
ResourceUri      : http://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

Get-ChildItem WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName     ParamValue
---------     ----------
PSVersion     2.0
startupscript C:\ps-test\Maintenance.ps1

Parameter

-AccessMode

Mengaktifkan dan menonaktifkan konfigurasi sesi dan menentukan apakah dapat digunakan untuk sesi jarak jauh atau lokal di komputer. Nilai yang dapat diterima untuk parameter ini adalah:

• Disabled. Menonaktifkan konfigurasi sesi. Ini tidak dapat digunakan untuk akses jarak jauh atau lokal ke komputer. Nilai ini mengatur properti Diaktifkan dari konfigurasi sesi (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled) ke False.
• Local. Menambahkan entri Network_Deny_All ke pendeskripsi keamanan konfigurasi sesi. Pengguna komputer lokal dapat menggunakan konfigurasi sesi untuk membuat sesi loopback lokal di komputer yang sama, tetapi pengguna jarak jauh ditolak aksesnya.
• Remote. Menghapus entri Deny_All dan Network_Deny_All dari deskriptor keamanan konfigurasi sesi. Pengguna komputer lokal dan jarak jauh dapat menggunakan konfigurasi sesi untuk membuat sesi dan menjalankan perintah pada komputer ini.

Nilai defaultnya adalah Jarak Jauh .

Cmdlet lain dapat mengambil alih nilai parameter ini nanti. Misalnya, cmdlet Enable-PSRemoting memungkinkan semua konfigurasi sesi di komputer dan mengizinkan akses jarak jauh ke mereka, dan cmdlet Disable-PSRemoting hanya mengizinkan akses lokal ke semua konfigurasi sesi di komputer.

Parameter ini diperkenalkan di PowerShell 3.0.

Properti parameter

Jenis:	PSSessionConfigurationAccessMode
Nilai default:	None
Nilai yang diterima:	Disabled, Local, Remote
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

-ApplicationBase

Menentukan jalur file rakitan (*.dll) yang ditentukan dalam nilai parameter AssemblyName.

Properti parameter

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

Kumpulan parameter

NameParameterSet

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

AssemblyNameParameterSet

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

-AssemblyName

Menentukan nama rakitan. Cmdlet ini membuat konfigurasi sesi berdasarkan kelas yang ditentukan dalam rakitan.

Masukkan nama file atau jalur lengkap file assembly .dll yang menentukan konfigurasi sesi. Jika Anda hanya memasukkan nama file, Anda dapat memasukkan jalur dalam nilai parameter ApplicationBase.

Properti parameter

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

Kumpulan parameter

AssemblyNameParameterSet

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ConfigurationTypeName

Menentukan jenis konfigurasi sesi yang ditentukan dalam rakitan dalam parameter AssemblyName. Jenis yang Anda tentukan harus mengimplementasikan kelas System.Management.Automation.Remoting.PSSessionConfiguration .

Parameter ini diperlukan saat Anda menentukan nama rakitan.

Properti parameter

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

Kumpulan parameter

AssemblyNameParameterSet

Position:	2
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

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

-Force

Menekan semua permintaan pengguna, dan memulai ulang layanan WinRM tanpa meminta. Memulai ulang layanan membuat perubahan konfigurasi efektif.

Untuk mencegah restart dan menekan perintah hidupkan ulang, gunakan parameter NoServiceRestart.

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

-MaximumReceivedDataSizePerCommandMB

Menentukan batas jumlah data yang dapat dikirim ke komputer ini dalam satu perintah jarak jauh. Masukkan ukuran data dalam megabyte (MB). Defaultnya adalah 50.

Jika batas ukuran data ditentukan dalam jenis konfigurasi yang ditentukan dalam parameter ConfigurationTypeName, batas dalam jenis konfigurasi digunakan. Nilai parameter ini diabaikan.

Properti parameter

Jenis:	Nullable<T>[Double]
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

-MaximumReceivedObjectSizeMB

Menentukan batasan jumlah data yang dapat dikirim ke komputer ini dalam satu objek. Masukkan ukuran data dalam megabyte. Defaultnya adalah 10.

Jika batas ukuran objek ditentukan dalam jenis konfigurasi yang ditentukan dalam parameter ConfigurationTypeName, batas dalam jenis konfigurasi digunakan. Nilai parameter ini diabaikan.

Properti parameter

Jenis:	Nullable<T>[Double]
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

-ModulesToImport

Menentukan modul dan snap-in yang secara otomatis diimpor ke dalam sesi yang menggunakan konfigurasi sesi. Masukkan nama modul dan snap-in.

Secara default, hanya modul Microsoft.PowerShell.Core yang diimpor ke dalam sesi, tetapi kecuali cmdlet dikecualikan, Anda dapat menggunakan cmdlet Import-Module dan Add-PSSnapin untuk menambahkan modul dan snap-in ke sesi.

Modul yang ditentukan dalam nilai parameter ini diimpor sebagai tambahan untuk modul yang ditentukan dalam file konfigurasi sesi (New-PSSessionConfigurationFile). Namun, pengaturan dalam file konfigurasi sesi dapat menyembunyikan perintah yang diekspor oleh modul atau mencegah pengguna menggunakannya.

Modul yang ditentukan dalam nilai parameter ini menggantikan daftar modul yang ditentukan dengan parameter ModulesToImport cmdlet Register-PSSessionConfiguration.

Parameter ini diperkenalkan di PowerShell 3.0.

Properti parameter

Jenis:	Object[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameParameterSet

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

AssemblyNameParameterSet

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

-Name

Menentukan nama konfigurasi sesi yang ingin Anda ubah.

Anda tidak dapat menggunakan parameter ini untuk mengubah nama konfigurasi sesi.

Properti parameter

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

Kumpulan parameter

(All)

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-NoServiceRestart

Tidak memulai ulang layanan WinRM, dan menekan permintaan untuk memulai ulang layanan.

Secara default, saat Anda menjalankan , Anda diminta untuk memulai ulang layanan WinRM agar konfigurasi sesi baru efektif. Hingga layanan WinRM dimulai ulang, konfigurasi sesi baru tidak efektif.

Untuk memulai ulang layanan WinRM tanpa meminta, gunakan parameter Force. Untuk memulai ulang layanan WinRM secara manual, gunakan cmdlet Restart-Service.

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

-Path

Menentukan jalur file konfigurasi sesi (.pssc), seperti yang dibuat oleh cmdlet New-PSSessionConfigurationFile. Jika Anda menghilangkan jalur, defaultnya adalah direktori saat ini.

Untuk informasi tentang cara mengubah file konfigurasi sesi, lihat topik bantuan untuk cmdlet New-PSSessionConfigurationFile.

Parameter ini diperkenalkan di PowerShell 3.0.

Properti parameter

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

Kumpulan parameter

SessionConfigurationFile

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PSVersion

Menentukan versi PowerShell dalam sesi yang menggunakan konfigurasi sesi ini.

Nilai parameter ini lebih diutamakan daripada nilai kunci PowerShellVersion dalam file konfigurasi sesi.

Parameter ini diperkenalkan di PowerShell 3.0.

Properti parameter

Jenis:	Version
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Versi PowerShell

Kumpulan parameter

NameParameterSet

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

AssemblyNameParameterSet

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

-RunAsCredential

Menentukan kredensial untuk perintah dalam sesi. Secara default, perintah berjalan dengan izin pengguna saat ini.

Parameter ini diperkenalkan di PowerShell 3.0.

Properti parameter

Jenis:	PSCredential
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

-SecurityDescriptorSddl

Menentukan string Security Descriptor Definition Language (SDDL) yang berbeda untuk konfigurasi.

String ini menentukan izin yang diperlukan untuk menggunakan konfigurasi sesi baru. Untuk menggunakan konfigurasi sesi dalam sesi, pengguna harus memiliki setidaknya izin Execute(Invoke) untuk konfigurasi.

Untuk menggunakan deskriptor keamanan default untuk konfigurasi, masukkan string kosong ("") atau nilai $null. Defaultnya adalah SDDL root di drive WSMan:.

Jika deskriptor keamanan kompleks, pertimbangkan untuk menggunakan parameter ShowSecurityDescriptorUI, bukan yang ini. Anda tidak dapat menggunakan kedua parameter dalam perintah yang sama.

Properti parameter

Jenis:	String
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

-SessionTypeOption

Menentukan opsi khusus jenis untuk konfigurasi sesi. Masukkan objek opsi jenis sesi, seperti objek PSWorkflowExecutionOption yang dikembalikan cmdlet .

Opsi sesi yang menggunakan konfigurasi sesi ditentukan oleh nilai opsi sesi dan opsi konfigurasi sesi. Kecuali ditentukan, opsi yang diatur dalam sesi, seperti dengan cmdlet New-PSSessionOption, lebih diutamakan daripada opsi yang diatur dalam konfigurasi sesi. Namun, nilai opsi sesi tidak boleh melebihi nilai maksimum yang ditetapkan dalam konfigurasi sesi.

Parameter ini diperkenalkan di PowerShell 3.0.

Properti parameter

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

Kumpulan parameter

NameParameterSet

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

AssemblyNameParameterSet

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

-ShowSecurityDescriptorUI

Ketika parameter ini digunakan, cmdlet membuka lembar properti yang membantu Anda membuat SDDL baru untuk konfigurasi sesi. Lembar properti muncul setelah Anda menjalankan perintah Set-PSSessionConfiguration lalu memulai ulang layanan WinRM.

Saat Anda mengatur izin ke konfigurasi, ingatlah bahwa pengguna harus memiliki setidaknya izin Execute(Invoke) untuk menggunakan konfigurasi sesi dalam sesi.

Anda tidak dapat menggunakan parameter SecurityDescriptorSDDL dan parameter ini dalam perintah yang sama.

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

-StartupScript

Menentukan skrip startup untuk konfigurasi. Masukkan jalur skrip PowerShell yang sepenuhnya memenuhi syarat. Skrip yang ditentukan berjalan di sesi baru yang menggunakan konfigurasi sesi.

Untuk menghapus skrip startup dari konfigurasi sesi, masukkan string kosong ("") atau nilai $null.

Anda dapat menggunakan skrip startup untuk mengonfigurasi sesi pengguna lebih lanjut. Jika skrip menghasilkan kesalahan, bahkan kesalahan yang tidak mengakhiri, sesi tidak dibuat dan perintah New-PSSession gagal.

Properti parameter

Jenis:	String
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

-ThreadApartmentState

Menentukan status apartemen modul utas yang akan digunakan. Nilai yang dapat diterima adalah:

• Unknown
• MTA
• STA

Properti parameter

Jenis:	ApartmentState
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

-ThreadOptions

Menentukan pengaturan opsi utas dalam konfigurasi. Pengaturan ini menentukan bagaimana utas dibuat dan digunakan saat perintah dijalankan dalam sesi. Nilai yang dapat diterima untuk parameter ini adalah:

• Default
• ReuseThread
• UseCurrentThread
• UseNewThread

Nilai defaultnya adalah UseCurrentThread.

Untuk informasi selengkapnya, lihat Enumerasi PSThreadOptions .

Properti parameter

Jenis:	PSThreadOptions
Nilai default:	None
Nilai yang diterima:	Default, UseNewThread, ReuseThread, UseCurrentThread
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

-TransportOption

Menentukan opsi transportasi untuk konfigurasi sesi. Masukkan objek opsi transportasi, seperti objek WSManConfigurationOption yang dikembalikan cmdlet New-PSTransportOption.

Opsi sesi yang menggunakan konfigurasi sesi ditentukan oleh nilai opsi sesi dan opsi konfigurasi sesi. Kecuali ditentukan, opsi yang diatur dalam sesi, seperti dengan cmdlet New-PSSessionOption, lebih diutamakan daripada opsi yang diatur dalam konfigurasi sesi. Namun, nilai opsi sesi tidak boleh melebihi nilai maksimum yang ditetapkan dalam konfigurasi sesi.

Parameter ini diperkenalkan di PowerShell 3.0.

Properti parameter

Jenis:	PSTransportOption
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

-UseSharedProcess

Gunakan hanya satu proses untuk menghosting semua sesi yang dimulai oleh pengguna yang sama dan menggunakan konfigurasi sesi yang sama. Secara default, setiap sesi dihosting dalam prosesnya sendiri.

Parameter ini diperkenalkan di PowerShell 3.0.

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

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
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

WSManConfigLeafElement

Catatan

Cmdlet ini hanya tersedia di platform Windows.

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

Cmdlet tidak mengubah nama konfigurasi dan penyedia WSMan tidak mendukung cmdlet . Untuk mengubah nama konfigurasi sesi, gunakan cmdlet Unregister-PSSessionConfiguration untuk menghapus konfigurasi lalu gunakan cmdlet Register-PSSessionConfiguration untuk membuat dan mendaftarkan konfigurasi sesi baru.

Anda dapat menggunakan cmdlet Set-PSSessionConfiguration untuk mengubah konfigurasi sesi Microsoft.PowerShell dan Microsoft.PowerShell32 default. Mereka tidak dilindungi. Untuk kembali ke versi asli konfigurasi sesi default, gunakan cmdlet Unregister-PSSessionConfiguration untuk menghapus konfigurasi sesi default lalu gunakan cmdlet Enable-PSRemoting untuk memulihkannya.

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 Windows PowerShell 2.0 tidak menghasilkan kesalahan, tetapi tidak efektif. Untuk mengubah properti yang diperkenalkan di PowerShell 3.0, gunakan drive WSMan: di PowerShell 3.0 atau yang lebih baru.

Link Terkait

• Disable-PSSessionConfiguration (Nonaktifkan Konfigurasi Sesi PS)
• Mengaktifkan Konfigurasi PSSession (Enable-PSSessionConfiguration)
• Get-PSSessionConfiguration
• New-PSSessionConfigurationFile (Membuat File Konfigurasi Sesi Baru di PowerShell)
• New-PSSessionOption
• New-PSTransportOption
• Register-PSSessionConfiguration
• Test-PSSessionConfigurationFile (Pengujian Berkas Konfigurasi PSSession)
• Unregister-PSSessionConfiguration
• Penyedia WSMan
• tentang_Konfigurasi_Sesi
• tentang_File_Konfigurasi_Sesi