Set-PSSessionConfiguration

Modül:: Microsoft.PowerShell.Core Module

Kayıtlı oturum yapılandırmasının özelliklerini değiştirir.

Syntax

NameParameterSet (Varsayılan)

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>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Set-PSSessionConfiguration cmdlet'i, yerel bilgisayardaki oturum yapılandırmalarının özelliklerini değiştirir.

Değiştirmek istediğiniz oturum yapılandırmasını tanımlamak için Name parametresini kullanın. Oturum yapılandırmasının özellikleri için yeni değerler belirtmek üzere diğer parametreleri kullanın. Yapılandırmadan bir özellik değerini silmek ve varsayılan değeri kullanmak için boş bir dize ("") veya karşılık gelen parametre için $null değeri girin.

PowerShell 3.0'dan başlayarak, oturum yapılandırması tanımlamak için bir oturum yapılandırma dosyası kullanabilirsiniz. Bu özellik, oturum yapılandırmasını kullanan oturumların özelliklerini ayarlamak ve değiştirmek için basit ve bulunabilir bir yöntem sağlar. Oturum yapılandırma dosyası belirtmek için Set-PSSessionConfiguration parametresini kullanın. Oturum yapılandırma dosyaları hakkında bilgi için bkz. about_Session_Configuration_Files. Oturum yapılandırma dosyası oluşturma ve değiştirme hakkında bilgi için New-PSSessionConfigurationFile cmdlet'ine bakın.

Oturum yapılandırmaları, yerel bilgisayara bağlanan uzak oturumların (PSSessions) ortamını tanımlar. Her PSSession bir oturum yapılandırması kullanır. Oturum yapılandırması, oturumda kullanılabilen modüller, çalıştırılmasına izin verilen cmdlet'ler, dil modu, kotalar ve zaman aşımları gibi PSSessionözelliklerini belirler. Oturum yapılandırmasının güvenlik tanımlayıcısı, yerel bilgisayara bağlanmak için oturum yapılandırmasını kimlerin kullanabileceğini belirler. Oturum yapılandırmaları hakkında daha fazla bilgi için bkz. about_Session_Configurations.

Oturum yapılandırmasının özelliklerini görmek için Get-PSSessionConfiguration cmdlet'ini veya WSMan Sağlayıcısı'nı kullanın. WSMan Sağlayıcısı hakkında daha fazla bilgi için Get-Help WSManyazın.

Örnekler

Örnek 1: Oturum yapılandırması oluşturma ve değiştirme

Bu örnekte, bir yapılandırmaya başlangıç betiği ekleme ve kaldırma işlemi gösterilmektedir.

İlk komut, AdminShell yapılandırmasını oluşturur. İkinci komut, AdminConfig.ps1 betiğini yapılandırmaya ekler. Değişiklik, WinRMyeniden başlattığınızda etkilidir. Üçüncü komut, AdminConfig.ps1 betiğini yapılandırmadan kaldırır.

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

Örnek 2: Sonuçları görüntüleme

Bu örnek, MaximumReceivedObjectSizeMB özelliğinin değerini 20olarak artırır. Bu komut ayrıca WinRM hizmetini yeniden başlatmanızı ister. WinRM hizmeti yeniden başlatılana kadar değişiklik geçerli olmaz.

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

Örnek 3: Sonuçları farklı şekillerde görüntüleme

Bu örnekte Set-PSSessionConfigurationMaintenanceShell oturum yapılandırmasındaki başlangıç betiğini Maintenance.ps1olarak değiştirir. Çıktıda değişiklik gösterilir ve WinRM hizmetini yeniden başlatmanız istenir. Yanıt y (evet) olur.

Get-PSSessionConfiguration MaintenanceShell oturum yapılandırmasını alır. İşlem hattı işleci (|), komutun sonuçlarını Format-List'a gönderir ve bu da yapılandırma nesnesinin tüm özelliklerini bir listede görüntüler. Ardından WSMan sağlayıcısını kullanarak MaintenanceShell yapılandırması için başlatma parametrelerini görüntüleyeceğiz. Get-ChildItem, MaintenanceShell eklentisi için InitializationParameters düğümündeki alt öğeleri alır. WSMan sağlayıcısı hakkında daha fazla bilgi için Get-Help WSManyazın.

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

Parametreler

-AccessMode

Oturum yapılandırmasını etkinleştirir ve devre dışı bırakır ve bilgisayardaki uzak veya yerel oturumlar için kullanılıp kullanılamayacağını belirler. Bu parametre için kabul edilebilir değerler şunlardır:

Disabled. Oturum yapılandırmasını devre dışı bırakır. Bilgisayara uzaktan veya yerel erişim için kullanılamaz. Bu değer, oturum yapılandırmasının () WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled özelliğini Falseolarak ayarlar.
Local. Oturum yapılandırmasının güvenlik tanımlayıcısına bir Network_Deny_All girişi ekler. Yerel bilgisayarın kullanıcıları oturum yapılandırmasını kullanarak aynı bilgisayarda yerel bir geri döngü oturumu oluşturabilir, ancak uzak kullanıcıların erişimi reddedilir.
Remote. Oturum yapılandırmasının güvenlik tanımlayıcılarından Deny_All ve Network_Deny_All girdilerini kaldırır. Yerel ve uzak bilgisayarların kullanıcıları oturumları oluşturmak ve bu bilgisayarda komut çalıştırmak için oturum yapılandırmasını kullanabilir.

Varsayılan değer Uzakdeğeridir.

Diğer cmdlet'ler bu parametrenin değerini daha sonra geçersiz kılabilir. Örneğin, Enable-PSRemoting cmdlet'i bilgisayardaki tüm oturum yapılandırmalarını etkinleştirir ve bunlara uzaktan erişime izin verir ve Disable-PSRemoting cmdlet'i bilgisayardaki tüm oturum yapılandırmalarına yalnızca yerel erişime izin verir.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	PSSessionConfigurationAccessMode
Default value:	None
Kabul edilen değerler:	Disabled, Local, Remote
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ApplicationBase

*.dll parametresinin değerinde belirtilen derleme dosyasının () yolunu belirtir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

NameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AssemblyNameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-AssemblyName

Derleme adını belirtir. Bu cmdlet, bir derlemede tanımlanan sınıfı temel alan bir oturum yapılandırması oluşturur.

Oturum yapılandırmasını tanımlayan bir derleme .dll dosyasının dosya adını veya tam yolunu girin. Yalnızca dosya adını girerseniz, yolu ApplicationBase parametresinin değerine girebilirsiniz.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

AssemblyNameParameterSet

Position:	1
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ConfigurationTypeName

AssemblyName parametresindeki derlemede tanımlanan oturum yapılandırmasının türünü belirtir. Belirttiğiniz tür, System.Management.Automation.Remoting.PSSessionConfiguration sınıfını uygulamalıdır.

Bir derleme adı belirttiğinizde bu parametre gereklidir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

AssemblyNameParameterSet

Position:	2
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Force

Tüm kullanıcı istemlerini gizler ve istemeden WinRM hizmetini yeniden başlatır. Hizmetin yeniden başlatılması yapılandırma değişikliğini etkili hale getirir.

Yeniden başlatmayı önlemek ve yeniden başlatma istemini engellemek için NoServiceRestart parametresini kullanın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaximumReceivedDataSizePerCommandMB

Herhangi bir uzak komutta bu bilgisayara gönderilebilen veri miktarının sınırını belirtir. Veri boyutunu megabayt (MB) cinsinden girin. Varsayılan değer: 50.

ConfigurationTypeName parametresinde belirtilen yapılandırma türünde bir veri boyutu sınırı tanımlanmışsa, yapılandırma türündeki sınır kullanılır. Bu parametrenin değeri yoksayılır.

Parametre özellikleri

Tür:	Nullable<T>[Double]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaximumReceivedObjectSizeMB

Bu bilgisayara tek bir nesnede gönderilebilen veri miktarının sınırlarını belirtir. Veri boyutunu megabayt cinsinden girin. Varsayılan değer: 10.

ConfigurationTypeName parametresinde belirtilen yapılandırma türünde bir nesne boyutu sınırı tanımlanmışsa, yapılandırma türündeki sınır kullanılır. Bu parametrenin değeri yoksayılır.

Parametre özellikleri

Tür:	Nullable<T>[Double]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ModulesToImport

Oturum yapılandırmasını kullanan oturumlara otomatik olarak içeri aktarılan modülleri ve ek bileşenleri belirtir. Modül ve ek bileşen adlarını girin.

Varsayılan olarak, oturumlara yalnızca Microsoft.PowerShell.Core modülü aktarılır, ancak cmdlet'ler dışlanmadığı sürece Import-Module ve Add-PSSnapin cmdlet'lerini kullanarak oturuma modüller ve ek bileşenler ekleyebilirsiniz.

Bu parametre değerinde belirtilen modüller, oturum yapılandırma dosyasında (New-PSSessionConfigurationFile) belirtilen modüllere ek olarak içeri aktarılır. Ancak, oturum yapılandırma dosyasındaki ayarlar modüller tarafından dışarı aktarılan komutları gizleyebilir veya kullanıcıların bunları kullanmasını engelleyebilir.

Bu parametre değerinde belirtilen modüller, cmdlet'in Register-PSSessionConfiguration parametresiyle belirtilen modüllerin listesinin yerini alır.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	Object[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

NameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AssemblyNameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Name

Değiştirmek istediğiniz oturum yapılandırmasının adını belirtir.

Oturum yapılandırmasının adını değiştirmek için bu parametreyi kullanamazsınız.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-NoServiceRestart

WinRM hizmetini yeniden başlatmaz ve hizmeti yeniden başlatma istemini gizler.

Varsayılan olarak, Set-PSSessionConfigurationçalıştırdığınızda, yeni oturum yapılandırmasını etkili hale getirmek için WinRM hizmetini yeniden başlatmanız istenir. WinRM hizmeti yeniden başlatılana kadar yeni oturum yapılandırması etkili olmaz.

WinRM hizmetini sormadan yeniden başlatmak için Zorla parametresini kullanın. WinRM hizmetini el ile yeniden başlatmak için Restart-Service cmdlet'ini kullanın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Path

.pssc cmdlet'i tarafından oluşturulan bir oturum yapılandırma dosyasının (New-PSSessionConfigurationFile) yolunu belirtir. Yolu atlarsanız, varsayılan dizin geçerli dizindir.

Oturum yapılandırma dosyasını değiştirme hakkında bilgi için New-PSSessionConfigurationFile cmdlet'inin yardım konusuna bakın.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SessionConfigurationFile

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PSVersion

Bu oturum yapılandırmasını kullanan oturumlarda PowerShell sürümünü belirtir.

Bu parametrenin değeri, oturum yapılandırma dosyasındaki PowerShellVersion anahtarının değerinden önceliklidir.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	Version
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	PowerShell Sürümü

Parametre kümeleri

NameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AssemblyNameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RunAsCredential

Oturumdaki komutlar için kimlik bilgilerini belirtir. Varsayılan olarak, komutlar geçerli kullanıcının izinleriyle çalışır.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SecurityDescriptorSddl

Yapılandırma için farklı bir Güvenlik Tanımlayıcısı Tanım Dili (SDDL) dizesi belirtir.

Bu dize, yeni oturum yapılandırmasını kullanmak için gereken izinleri belirler. Oturumda oturum yapılandırması kullanmak için kullanıcıların yapılandırma için en az Execute(Invoke) izni olmalıdır.

Yapılandırma için varsayılan güvenlik tanımlayıcısını kullanmak için boş bir dize ("") veya $nulldeğeri girin. Varsayılan değer, WSMan: sürücüsündeki kök SDDL'dir.

Güvenlik tanımlayıcısı karmaşıksa, bunun yerine ShowSecurityDescriptorUI parametresini kullanmayı göz önünde bulundurun. Aynı komutta her iki parametreyi de kullanamazsınız.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SessionTypeOption

Oturum yapılandırması için türe özgü seçenekleri belirtir. cmdlet'in döndürdüğü New-PSWorkflowExecutionOption nesnesi gibi bir oturum türü seçenekleri nesnesi girin.

Oturum yapılandırmasını kullanan oturum seçenekleri, oturum seçeneklerinin ve oturum yapılandırma seçeneklerinin değerlerine göre belirlenir. Belirtilmediği sürece, oturumda ayarlanan New-PSSessionOption cmdlet'i gibi seçenekler, oturum yapılandırmasında ayarlanan seçeneklerden önceliklidir. Ancak, oturum seçeneği değerleri oturum yapılandırmasında ayarlanan en yüksek değerleri aşamaz.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	PSSessionTypeOption
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

NameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

AssemblyNameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ShowSecurityDescriptorUI

Bu parametre kullanıldığında cmdlet, oturum yapılandırması için yeni bir SDDL oluşturmanıza yardımcı olan bir özellik sayfası açar. özellik sayfası, komutunu çalıştırdıktan ve winrm hizmetini yeniden başlattıktan sonra görüntülenir.

Yapılandırma izinlerini ayarladığınızda, kullanıcıların bir oturumda oturum yapılandırmasını kullanmak için en az Execute(Invoke) iznine sahip olması gerektiğini unutmayın.

SecurityDescriptorSDDL parametresini ve bu parametreyi aynı komutta kullanamazsınız.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-StartupScript

Yapılandırma için başlangıç betiğini belirtir. PowerShell betiğinin tam yolunu girin. Belirtilen betik, oturum yapılandırmasını kullanan yeni oturumda çalışır.

Başlangıç betiğini oturum yapılandırmasından silmek için boş bir dize ("") veya $nulldeğeri girin.

Kullanıcı oturumunu daha fazla yapılandırmak için bir başlangıç betiği kullanabilirsiniz. Betik sonlandırıcı olmayan bir hata bile olsa bir hata oluşturursa oturum oluşturulmaz ve New-PSSession komutu başarısız olur.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ThreadApartmentState

Kullanılacak iş parçacığı oluşturma modülünün daire durumunu belirtir. Kabul edilebilir değerler şunlardır:

Unknown
MTA
STA

Parametre özellikleri

Tür:	ApartmentState
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ThreadOptions

Yapılandırmadaki iş parçacığı seçenekleri ayarını belirtir. Bu ayar, oturumda bir komut yürütürken iş parçacıklarının nasıl oluşturulup kullanılacağını tanımlar. Bu parametre için kabul edilebilir değerler şunlardır:

Default
ReuseThread
UseCurrentThread
UseNewThread

Varsayılan değer şudur: UseCurrentThread.

Daha fazla bilgi için bkz. PSThreadOptions Numaralandırması.

Parametre özellikleri

Tür:	PSThreadOptions
Default value:	None
Kabul edilen değerler:	Default, UseNewThread, ReuseThread, UseCurrentThread
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-TransportOption

Oturum yapılandırması için aktarım seçeneklerini belirtir. cmdlet'in döndürdüğü New-PSTransportOption nesnesi gibi bir aktarım seçenekleri nesnesi girin.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	PSTransportOption
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-UseSharedProcess

Aynı kullanıcı tarafından başlatılan tüm oturumları barındırmak ve aynı oturum yapılandırmasını kullanmak için yalnızca bir işlem kullanın. Varsayılan olarak, her oturum kendi işleminde barındırılır.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

WSManConfigLeafElement

Notlar

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.

Bu cmdlet'i çalıştırmak için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın.

Set-PSSessionConfiguration cmdlet'i yapılandırma adını değiştirmez ve WSMan sağlayıcısı Rename-Item cmdlet'ini desteklemez. Oturum yapılandırmasının adını değiştirmek için Unregister-PSSessionConfiguration cmdlet'ini kullanarak yapılandırmayı silin ve ardından yeni bir oturum yapılandırması oluşturup kaydetmek için Register-PSSessionConfiguration cmdlet'ini kullanın.

Varsayılan Set-PSSessionConfiguration ve Microsoft.PowerShell oturum yapılandırmalarını değiştirmek için Microsoft.PowerShell32 cmdlet'ini kullanabilirsiniz. Bunlar korunmaz. Varsayılan oturum yapılandırmasının özgün sürümüne dönmek için Unregister-PSSessionConfiguration cmdlet'ini kullanarak varsayılan oturum yapılandırmasını silin ve ardından Enable-PSRemoting cmdlet'ini kullanarak geri yükleyin.

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.

Oturum yapılandırmalarının özelliklerini değiştirmek için WSMan: sürücüsündeki komutları kullanabilirsiniz. Ancak, PowerShell 3.0'da tanıtılan WSMan:gibi oturum yapılandırma özelliklerini değiştirmek için PowerShell 2.0'daki sürücüsünü kullanamazsınız. Windows PowerShell 2.0 komutları hata oluşturmaz, ancak etkisizdir. PowerShell 3.0'da sunulan özellikleri değiştirmek için PowerShell 3.0 veya sonraki sürümlerde WSMan: sürücüsünü kullanın.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?