Set-PSSessionConfiguration
Kayıtlı 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>]
Description
Cmdlet, Set-PSSessionConfiguration
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 ö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, karşılık gelen parametre için boş bir dize (""
) veya değeri $Null
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 path parametresini Set-PSSessionConfiguration
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 cmdlet'ine New-PSSessionConfigurationFile
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 ö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 edinmek için bkz. about_Session_Configurations.
Oturum yapılandırmasının özelliklerini görmek için cmdlet'ini Get-PSSessionConfiguration
veya WSMan Sağlayıcısı'nı kullanın. WSMan Sağlayıcısı hakkında daha fazla bilgi için yazın Get-Help WSMan
.
Örnekler
Örnek 1: İş parçacığı apartman durumunu değiştirme
PS C:\> Set-PSSessionConfiguration -Name "MaintenanceShell" -ThreadApartmentState STA
Bu komut MaintenanceShell yapılandırmasındaki iş parçacığı apartman durumunu STA olarak değiştirir. Değişiklik, WinRM hizmetini yeniden başlattığınızda etkilidir.
Örnek 2: Oturum yapılandırmasını 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 betiği yapılandırmaya ekler AdminConfig.ps1
. Değişiklik, WinRM'yi yeniden başlattığınızda etkindir.
Üçüncü komut, betiği yapılandırmadan kaldırır AdminConfig.ps1
.
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 3: Sonuçları görüntüleme
Bu örnek MaximumReceivedObjectSizeMB özelliğinin değerini olarak 20
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-PSSessionConfiguration
MaintenanceShell oturum yapılandırmasındaki başlangıç betiğini olarak Maintenance.ps1
değiştirir. Çıkış, değişikliği gösterir ve WinRM hizmetini yeniden başlatmanızı ister. Yanıt: y
(evet).
Get-PSSessionConfiguration
MaintenanceShell oturum yapılandırmasını alır. İşlem hattı işleci (|
), komutun Format-List
sonuçlarını bir listede yapılandırma nesnesinin tüm özelliklerini görüntüleyen öğesine gönderir. 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 yazın 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
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 parametrenin kabul edilebilir değerleri ş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 Enabled özelliğini (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled
) olarakFalse
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 Uzak'tır.
Diğer cmdlet'ler bu parametrenin değerini daha sonra geçersiz kılabilir. Örneğin, Enable-PSRemoting
cmdlet bilgisayardaki tüm oturum yapılandırmalarını etkinleştirir ve bunlara uzaktan erişime izin verir ve Disable-PSRemoting
cmdlet yalnızca bilgisayardaki tüm oturum yapılandırmalarına yerel erişime izin verir.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | PSSessionConfigurationAccessMode |
Kabul edilen değerler: | Disabled, Local, Remote |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ApplicationBase
AssemblyName parametresinin değerinde belirtilen derleme dosyasının (*.dll
) yolunu belirtir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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, ApplicationBase parametresinin değerine yolu girebilirsiniz.
Tür: | String |
Position: | 1 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ConfigurationTypeName
AssemblyName parametresindeki derlemede 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.
Tür: | String |
Position: | 2 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Force
Tüm kullanıcı istemlerini gizler ve sormadan 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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | Nullable<T>[Double] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | Nullable<T>[Double] |
Position: | Named |
Default value: | 10 |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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 ve Add-PSSnapin
cmdlet'lerini kullanarak Import-Module
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 ModulesToImport parametresiyle belirtilen modüllerin listesinin Register-PSSessionConfiguration
yerini alır.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | Object[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | 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.
Tür: | String |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-NoServiceRestart
WinRM hizmetini yeniden başlatmaz ve hizmeti yeniden başlatma istemini gizler.
Varsayılan olarak, komutunu çalıştırdığınızdaSet-PSSessionConfiguration
, 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.
İstenmeden WinRM hizmetini yeniden başlatmak için Force parametresini kullanın. WinRM hizmetini el ile yeniden başlatmak için cmdlet'ini Restart-Service
kullanın.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Path
Cmdlet'i tarafından oluşturulan bir oturum yapılandırma dosyasının New-PSSessionConfigurationFile
(.pssc
gibi) 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 cmdlet'in yardım konusuna New-PSSessionConfigurationFile
bakın.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | Version |
Diğer adlar: | PowerShellVersion |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | PSCredential |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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ını 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 değeri $Null
girin. Varsayılan değer, sürücüdeki kök SDDL'dir WSMan:
.
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.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-SessionTypeOption
Oturum yapılandırması için türe özgü seçenekleri belirtir. Cmdlet'in döndürdüğü PSWorkflowExecutionOption nesnesi gibi bir oturum türü seçenekleri nesnesi New-PSWorkflowExecutionOption
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 cmdlet gibi New-PSSessionOption
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 en yüksek değerleri aşamaz.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | PSSessionTypeOption |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | 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ı, komutu çalıştırdıktan Set-PSSessionConfiguration
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)
izinlere sahip olması gerektiğini unutmayın.
SecurityDescriptorSDDL parametresini ve bu parametreyi aynı komutta kullanamazsınız.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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 değeri $Null
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
komut başarısız olur.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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
Tür: | ApartmentState |
Kabul edilen değerler: | STA, MTA, Unknown |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | 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ürken iş parçacıklarının nasıl oluşturulup kullanılacağını tanımlar. Bu parametrenin kabul edilebilir değerleri şunlardır:
Default
ReuseThread
UseCurrentThread
UseNewThread
Varsayılan değer şudur: UseCurrentThread
.
Daha fazla bilgi için bkz . PSThreadOptions Numaralandırması.
Tür: | PSThreadOptions |
Kabul edilen değerler: | Default, UseNewThread, ReuseThread, UseCurrentThread |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-TransportOption
Oturum yapılandırması için aktarım seçeneklerini belirtir. Cmdlet'in döndürdüğü WSManConfigurationOption nesnesi gibi bir aktarım seçenekleri nesnesi New-PSTransportOption
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 cmdlet gibi New-PSSessionOption
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 en yüksek değerleri aşamaz.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | PSTransportOption |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | 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 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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
Notlar
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 yapılandırma adını değiştirmez ve WSMan sağlayıcısı cmdlet'i Rename-Item
desteklemez. Oturum yapılandırmasının adını değiştirmek için cmdlet'ini Unregister-PSSessionConfiguration
kullanarak yapılandırmayı silin ve ardından cmdlet'ini Register-PSSessionConfiguration
kullanarak yeni bir oturum yapılandırması oluşturun ve kaydedin.
Varsayılan Microsoft.PowerShell
ve Microsoft.PowerShell32
oturum yapılandırmalarını değiştirmek için cmdlet'ini kullanabilirsinizSet-PSSessionConfiguration
. Bunlar korunmaz. Varsayılan oturum yapılandırmasının özgün sürümüne dönmek için cmdlet'ini Unregister-PSSessionConfiguration
kullanarak varsayılan oturum yapılandırmasını silin ve ardından cmdlet'ini Enable-PSRemoting
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 WSMan:
özelliklerini değiştirmek için sürücüdeki komutları kullanabilirsiniz.
Ancak, PowerShell 3.0'da sunulan OutputBufferingMode gibi oturum yapılandırma özelliklerini değiştirmek için PowerShell 2.0'daki sürücüyü kullanamazsınızWSMan:
. 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 sürücüyü kullanın WSMan:
.
İlişkili Bağlantılar
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- New-PSTransportOption
- New-PSWorkflowExecutionOption
- Register-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan Sağlayıcısı
- about_Session_Configurations
- about_Session_Configuration_Files
PowerShell