Set-PSSessionConfiguration (Microsoft.PowerShell.Core)

Set-PSSessionConfiguration

Modül:: Microsoft.PowerShell.Core

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

Sözdizimi

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

Set-PSSessionConfiguration
   [-Name] <String>
   [-AssemblyName] <String>
   [-ApplicationBase <String>]
   [-ConfigurationTypeName] <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>]

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

Tanım

Bu cmdlet yalnızca Windows platformunda mevcuttur.

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 Ad parametresini kullanın. Oturum yapılandırmasının özelliklerine ilişkin yeni değerleri belirlemek için diğer parametreleri kullanın. Yapılandırmadan bir özellik değerini silmek ve varsayılan değeri kullanmak için ilgili parametre için boş bir dize ("") veya $Null değerini girin.

PowerShell 3,0'dan başlayarak, bir oturum yapılandırmasını 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 keşfedilebilir bir yöntem sağlar. Bir oturum yapılandırma dosyası belirtmek için Set-PSSessionConfiguration'un Path parametresini kullanın. Oturum yapılandırma dosyaları hakkında bilgi için bkz. about_Session_Configuration_Files. Bir oturum yapılandırma dosyasının nasıl oluşturulacağı ve değiştirileceği 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ışmasına izin verilen cmdlet'ler, dil modu, kotalar ve zaman aşımları gibi PSSession'un ö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.

Bir 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 WSMan yazın.

Örnekler

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

Bu örnek, bir yapılandırmaya başlangıç komut dosyasının nasıl eklenip kaldırılacağını gösterir.

İlk komut AdminShell yapılandırmasını oluşturur. İkinci komut, AdminConfig.ps1 komut dosyasını yapılandırmaya ekler. Değişiklik WinRM'i yeniden başlattığınızda etkili olur. Üçüncü komut, AdminConfig.ps1 komut dosyasını 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 20'ye artırır. Bu komut aynı zamanda WinRM hizmetini yeniden başlatmanızı da ister. WinRM hizmeti yeniden başlatılana kadar değişiklik etkili 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üleyin

Bu örnekte, Set-PSSessionConfiguration, MaintenanceShell oturum yapılandırmasındaki başlangıç komut dosyasını Maintenance.ps1 olarak değiştirir. Çıktı, değişikliği gösterir ve WinRM hizmetini yeniden başlatmanızı ister. Yanıt y (evet) şeklindedir.

Get-PSSessionConfiguration, MaintenanceShell oturum yapılandırmasını alır. Boru hattı operatörü (|), komutun sonuçlarını, yapılandırma nesnesinin tüm özelliklerini bir listede görüntüleyen Format-List'e gönderir. Daha sonra, WSMan sağlayıcısını kullanarak MaintenanceShell yapılandırmasına ilişkin başlatma parametrelerini görüntüliyoruz. Get-ChildItem, MaintenanceShell eklentisinin InitializationParameters düğümündeki alt öğeleri alır. WSMan sağlayıcısı hakkında daha fazla bilgi için Get-Help wsman yazı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 oturumlar için mi yoksa yerel oturumlar için mi kullanılabileceğini belirler. Bu parametre için kabul edilebilir değerler şunlardır:

Devre dışı. 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 Enabled özelliğini (WSMan:\\PlugIn\\Enabled) False olarak ayarlar.
Yerel. 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ı, aynı bilgisayarda yerel bir geridöngü oturumu oluşturmak için oturum yapılandırmasını kullanabilir, ancak uzak kullanıcıların erişimi reddedilir.
Uzaktan. Oturum yapılandırmasının güvenlik tanımlayıcılarından Deny_All ve Network_Deny_All girişlerini kaldırır. Yerel ve uzak bilgisayarların kullanıcıları, bu bilgisayarda oturum oluşturmak ve komutları çalıştırmak için oturum yapılandırmasını kullanabilir.

Varsayılan değer Uzak'tır.

Diğer cmdlet'ler daha sonra bu parametrenin değerini 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 tüm oturum yapılandırmalarına yalnızca yerel erişime izin verir bilgisayarda.

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: PSSessionConfigurationAccessMode
Kabul edilen değerler:: Engelli, Yerel, Uzak
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-ApplicationBase

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

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-AssemblyName

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

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

Tip :: String
Konum:: 1
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-ConfigurationTypeName

Derlemede AssemblyName parametresinde tanımlanan oturum yapılandırmasının türünü belirtir. Belirttiğiniz türün System.Management.Automation.Remoting.PSSessionConfiguration sınıfını uygulaması gerekir.

Bir derleme adı belirttiğinizde bu parametre gereklidir.

Tip :: String
Konum:: 2
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Confirm

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

Tip :: SwitchParameter
Takma adlar:: cf
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Force

Tüm kullanıcı istemlerini bastırır ve WinRM hizmetini sormadan yeniden başlatır. Hizmetin yeniden başlatılması, yapılandırma değişikliğinin etkili olmasını sağlar.

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

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-MaximumReceivedDataSizePerCommandMB

Bu bilgisayara herhangi bir uzaktan komutla gönderilebilecek veri miktarı sınırını belirtir. Veri boyutunu megabayt (MB) cinsinden girin. Varsayılan 50'dir.

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 dikkate alınmaz.

Tip :: Null yapılabilir[Çift]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-MaximumReceivedObjectSizeMB

Bu bilgisayara herhangi bir tek nesnede gönderilebilecek veri miktarına ilişkin sınırları belirtir. Veri boyutunu megabayt cinsinden girin. Varsayılan 10'dur.

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 dikkate alınmaz.

Tip :: Null yapılabilir[Çift]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-ModulesToImport

Oturum yapılandırmasını kullanan oturumlara otomatik olarak 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 hariç tutulmadığı sürece Import-Module ve Add-'i kullanabilirsiniz. Oturuma modüller ve ek bileşenler eklemek için PSSnapin cmdlet'leri.

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

Bu parametre değerinde belirtilen modüller, Register-PSSessionConfiguration cmdlet'inin ModulesToImport parametresiyle belirtilen modül listesinin yerine geçer.

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: Object[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: 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.

Tip :: String
Konum:: 0
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-NoServiceRestart

WinRM hizmetini yeniden başlatmaz ve hizmeti yeniden başlatma istemini bastırır.

Varsayılan olarak, Set-PSSessionConfiguration'u çalıştırdığınızda, yeni oturum yapılandırmasının etkili olması 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 Force parametresini kullanın. WinRM hizmetini manuel olarak yeniden başlatmak için Restart-Service cmdlet'ini kullanın.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Path

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

Bir oturum yapılandırma dosyasının nasıl değiştirileceği hakkında bilgi için New-PSSessionConfigurationFile cmdlet'inin yardım konusuna bakın.

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-PSVersion

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

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

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: Sürüm
Takma adlar:: PowerShellVersion
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-RunAsCredential

Oturumdaki komutlara ilişkin kimlik bilgilerini belirtir. Varsayılan olarak komutlar geçerli kullanıcının izinleriyle çalıştırılır.

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: PSC kimlik bilgisi
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-SecurityDescriptorSddl

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

Bu dize, yeni oturum yapılandırmasını kullanmak için gereken izinleri belirler. Bir oturumda oturum yapılandırmasını kullanmak için kullanıcıların, yapılandırmaya yönelik en az Execute(Invoke) iznine sahip olması gerekir.

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

Güvenlik tanımlayıcısı karmaşıksa bunun yerine ShowSecurityDescriptorUI parametresini kullanmayı düşünün. Her iki parametreyi de aynı komutta kullanamazsınız.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-SessionTypeOption

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

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

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: PSSessionTypeOption
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: 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ı, Set-PSSessionConfiguration komutunu çalıştırdıktan ve ardından WinRM hizmetini yeniden başlattıktan sonra görünür.

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

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

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-StartupScript

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

Oturum yapılandırmasından bir başlangıç komut dosyasını silmek için boş bir dize ("") veya $Null değerini girin.

Kullanıcı oturumunu daha da yapılandırmak için bir başlangıç komut dosyası kullanabilirsiniz. Komut dosyası bir hata, hatta sonlandırılmayan bir hata oluşturursa, oturum oluşturulmaz ve New-PSSession komutu başarısız olur.

Tip :: String
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-ThreadApartmentState

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

Unknown

MTA

STA

Tip :: ApartmentState
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-ThreadOptions

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

Default

ReuseThread

UseCurrentThread

UseNewThread

Varsayılan değer UseCurrentThread'dir.

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

Tip :: PSThreadSeçenekleri
Kabul edilen değerler:: Varsayılan, UseNewThread, ReuseThread, UseCurrentThread
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-TransportOption

Oturum yapılandırmasına ilişkin aktarım seçeneklerini belirtir. New-PSTransportOption cmdlet'inin döndürdüğü WSManConfigurationOption nesnesi gibi bir aktarım seçenekleri nesnesi girin.

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: PSTaşıma Seçeneği
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: 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 tek bir işlem kullanın. Varsayılan olarak her oturum kendi sürecinde barındırılır.

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-WhatIf

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

Tip :: SwitchParameter
Takma adlar:: wi
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çı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. Bir 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 kaydettirmek için Register-PSSessionConfiguration cmdlet'ini kullanın.

Varsayılan Microsoft.PowerShell ve Microsoft.PowerShell32 oturum yapılandırmalarını değiştirmek için Set-PSSessionConfiguration cmdlet'ini kullanabilirsiniz. Korunmuyorlar. Varsayılan oturum yapılandırmasının orijinal sürümüne geri dönmek için, varsayılan oturum yapılandırmasını silmek üzere Unregister-PSSessionConfiguration cmdlet'ini kullanın ve ardından geri yüklemek için Enable-PSRemoting cmdlet'ini kullanın.

Bir 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ının ek özellikleri vardır.

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 sunulan OutputBufferingMode gibi oturum yapılandırma özelliklerini değiştirmek için PowerShell 2,0'daki WSMan: 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.

Set-PSSessionConfiguration (Microsoft.PowerShell.Core)