Aracılığıyla paylaş

Register-PSSessionConfiguration

Modül:
Microsoft.PowerShell.Core Module

Yeni bir oturum yapılandırması oluşturur ve kaydeder.

Syntax

NameParameterSet (Varsayılan) 

Register-PSSessionConfiguration
    [-Name] <String>
    [-ProcessorArchitecture <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 

Register-PSSessionConfiguration
    [-Name] <String>
    [-AssemblyName] <String>
    [-ConfigurationTypeName] <String>
    [-ProcessorArchitecture <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 

Register-PSSessionConfiguration
    [-Name] <String>
    -Path <String>
    [-ProcessorArchitecture <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.

Register-PSSessionConfiguration cmdlet'i, yerel bilgisayarda yeni bir oturum yapılandırması oluşturur ve kaydeder. Bu, uzak kullanıcılar için özel oturumlar oluşturmak için kullanabileceğiniz gelişmiş bir cmdlet'tir.

Her PowerShell oturumu (PSSession) uç nokta olarak da bilinen bir oturum yapılandırması kullanır. Kullanıcılar bilgisayara bağlanan bir oturum oluşturduğunuzda bir oturum yapılandırması seçebilir veya PowerShell uzaktan iletişimini etkinleştirdiğinizde kaydedilen varsayılan oturum yapılandırmasını kullanabilir. Kullanıcılar, geçerli oturumda oluşturulan uzak oturumlar için varsayılan yapılandırmayı belirten $PSSessionConfigurationName tercih değişkenini de ayarlayabilir.

Oturum yapılandırması, uzak oturum için ortamı tanımlar. Yapılandırma, oturumda hangi komutların ve dil öğelerinin kullanılabilir olduğunu belirleyebilir ve oturumun tek bir nesne veya komutta uzaktan alabileceği veri miktarını sınırlayanlar gibi bilgisayarı koruyan ayarları içerebilir. Oturum yapılandırmasının güvenlik tanımlayıcısı, hangi kullanıcıların oturum yapılandırmasını kullanma iznine sahip olduğunu belirler.

Yapılandırma öğelerini, yeni bir yapılandırma sınıfı uygulayan bir derleme kullanarak ve oturumda çalışan bir betik kullanarak tanımlayabilirsiniz. PowerShell 3.0'da başlayarak, oturum yapılandırmasını tanımlamak için bir oturum yapılandırma dosyası da kullanabilirsiniz.

Oturum yapılandırmaları hakkında bilgi için bkz. about_Session_Configurations. Oturum yapılandırma dosyaları hakkında bilgi için bkz. about_Session_Configuration_Files.

Örnekler

Örnek 1: NewShell oturum yapılandırmasını kaydetme

Bu örnekte NewShell oturum yapılandırmasını kaydediyoruz. AssemblyName ve ApplicationBase parametreleri, oturum yapılandırmasındaki cmdlet'leri ve sağlayıcıları belirten MyShell.dll dosyasının konumunu belirtir. ConfigurationTypeName parametresi, derlemeden kullanılacak yapılandırma sınıfını belirtir.

$sessionConfiguration = @{
    Name='NewShell'
    ApplicationBase='C:\MyShells\'
    AssemblyName='MyShell.dll'
    ConfigurationTypeName='MyClass'
}
Register-PSSessionConfiguration @sessionConfiguration

Bu yapılandırmayı kullanmak için New-PSSession -ConfigurationName NewShellyazın.

Örnek 2: MaintenanceShell oturum yapılandırmasını kaydetme

Bu örnek, MaintenanceShell oturum yapılandırmasını yerel bilgisayara kaydeder. StartupScript parametresi Maintenance.ps1 betiğini belirtir.

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

Kullanıcı bir New-PSSession komutu kullanıp MaintenanceShell yapılandırmasını seçtiğinde, Maintenance.ps1 betiği yeni oturumda çalışır. Betik oturumu yapılandırabilir. Bu, modülleri içeri aktarmayı ve oturum için yürütme ilkesini ayarlamayı içerir. Betik sonlandırılmayan hatalar da dahil olmak üzere herhangi bir hata oluşturursa, New-PSSession komutu başarısız olur.

Örnek 3: Oturum yapılandırmasını kaydetme

Bu örnek, AdminShell oturum yapılandırmasını kaydeder.

$sessionParams değişkeni, tüm parametre değerlerini içeren bir karma tablodur. Bu karma tablo, PowerShell splatting kullanılarak cmdlet'e geçirilir. Register-PSSessionConfiguration komutu, değişkeninin değerinde SDDL'yi belirtmek için $sddl parametresini ve nesne boyutu sınırını artırmak için maximumReceivedObjectSizeMB parametresini kullanır. Ayrıca oturumu yapılandıran bir betik belirtmek için StartupScript parametresini kullanır.

$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FASA;GWGX;;;WD)"
$sessionParams = @{
    Name="AdminShell"
    SecurityDescriptorSDDL=$sddl
    MaximumReceivedObjectSizeMB=20
    StartupScript="C:\scripts\AdminShell.ps1"
}
Register-PSSessionConfiguration @sessionParams

Örnek 4: Yapılandırma kapsayıcısı öğesi döndürme

Bu örnekte MaintenanceShell yapılandırmasını kaydetme gösterilmektedir. Register-PSSessionConfiguration, değişkeninde depolanan bir $s nesnesi döndürür. Format-List döndürülen nesnenin tüm özelliklerini görüntüler. PSPath özelliği, nesnenin WSMan: sürücüsünün dizininde depolandığını gösterir. Get-ChildItem (diğer ad dir), WSMan:\LocalHost\PlugIn yolundaki öğeleri görüntüler. Bunlar yeni MaintenanceShell yapılandırmasını ve PowerShell ile birlikte gelen iki varsayılan yapılandırmayı içerir.

$s = Register-PSSessionConfiguration -Name MaintenanceShell -StartupScript C:\ps-test\Maintenance.ps1
$s | Format-List -Property *
dir WSMan:\LocalHost\Plugin

PSPath            : Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell
PSParentPath      : Microsoft.WSMan.Management\WSMan::localhost\Plugin
PSChildName       : MaintenanceShell
PSDrive           : WSMan
PSProvider        : Microsoft.WSMan.Management\WSMan
PSIsContainer     : True
Keys              : {Name=MaintenanceShell}
Name              : MaintenanceShell
TypeNameOfElement : Container

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}

Örnek 5: Başlangıç betiğiyle oturum yapılandırmasını kaydetme

Bu örnekte, WithProfile oturum yapılandırmasını oluşturup kaydediyoruz. StartupScript parametresi, PowerShell'i oturum yapılandırmasını kullanan herhangi bir oturum için belirtilen betiği çalıştırmaya yönlendirir.

Register-PSSessionConfiguration -Name WithProfile -StartupScript Add-Profile.ps1

Betik, oturumun geçerli kapsamında kullanıcının CurrentUserAllHosts profilini çalıştırmak için nokta kaynağını kullanan tek bir komut içerir.

Profiller hakkında daha fazla bilgi için bkz. about_Profiles. Nokta kaynağını belirleme hakkında daha fazla bilgi için bkz. about_Scopes.

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:

  • Sakat. Oturum yapılandırmasını devre dışı bırakır. Bilgisayara uzak veya yerel erişim için kullanılamaz.
  • Yerel. Yerel bilgisayar kullanıcılarının oturum yapılandırmasını kullanarak aynı bilgisayarda yerel bir geri döngü oturumu oluşturmasına izin verir, ancak uzak kullanıcılara erişimi reddeder.
  • Uzaktan. Yerel ve uzak kullanıcıların oturumları oluşturmak ve bu bilgisayarda komut çalıştırmak için oturum yapılandırmasını kullanmasına izin verir.

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'i tüm oturum yapılandırmalarına uzaktan erişim sağlar, Enable-PSSessionConfiguration cmdlet'i oturum yapılandırmalarını etkinleştirir ve Disable-PSRemoting cmdlet'i tüm oturum yapılandırmalarına uzaktan erişimi engeller.

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. AssemblyName parametresinin değeri yol içermediğinde bu parametreyi kullanın. Varsayılan değer geçerli dizindir.

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

Yapılandırma türünün tanımlandığı derleme dosyasının (*.dll) adını belirtir. Bu parametrede veya ApplicationBase parametresinin değerinde .dll yolunu belirtebilirsiniz.

ConfigurationTypeName parametresini belirttiğinizde bu parametre gereklidir.

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

Bu yapılandırma için kullanılan Microsoft .NET Framework türünün tam adını belirtir. Belirttiğiniz tür, System.Management.Automation.Remoting.PSSessionConfiguration sınıfını uygulamalıdır.

Yapılandırma türünü uygulayan derleme dosyasını (*.dll) belirtmek için, AssemblyName belirtin ve ApplicationBase parametrelerini.

Tür oluşturmak, oturum yapılandırmasının bazı cmdlet parametrelerini ortaya çıkarma veya gizleme ya da kullanıcıların geçersiz kılamaz veri boyutu ve nesne boyutu sınırları ayarlama gibi daha fazla yönünü denetlemenize olanak tanır.

Bu parametreyi atlarsanız, oturum yapılandırması için DefaultRemotePowerShellConfiguration sınıfı kullanılır.

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 WinRM hizmetini sormadan 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 belirtin.

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ı için bir sınır belirtir. Veri boyutunu megabayt (MB) cinsinden girin. Varsayılan değer 50 MB'tır.

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

Tek bir nesnede bu bilgisayara gönderilebilen veri miktarı için bir sınır belirtir. Veri boyutunu megabayt cinsinden girin. Varsayılan değer 10 MB'tır.

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 ve bu parametrenin değeri yoksayılır.

Parametre özellikleri

Tür:

Nullable<T>[Double]

Default value:10
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 belirtir.

Varsayılan olarak, oturumlara yalnızca Microsoft.PowerShell.Core aktarılır. Cmdlet'ler dışlanmadığı sürece Import-Module kullanarak oturuma modül ekleyebilirsiniz.

Bu parametre değerinde belirtilen modüller, SessionType parametresi tarafından belirtilen modüllere ek olarak ve oturum yapılandırma dosyasında () New-PSSessionConfigurationFile anahtarında listelenen 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 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

Oturum yapılandırması için bir ad belirtir. Bu parametre gereklidir.

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, bir Register-PSSessionConfiguration komutu ç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 Force parametresini belirtin. WinRM hizmetini el ile yeniden başlatmak için Restart-Service cmdlet'ini kullanın.

Bu işlev PowerShell 7.5.0-preview.4'te uygulandı.

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

New-PSSessionConfigurationFiletarafından oluşturulan bir oturum yapılandırma dosyasının (.pssc) yolunu ve dosya adını belirtir. Yolu atlarsanız, varsayılan dizin geçerli dizindir.

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

-ProcessorArchitecture

PowerShell işleminin 32 bit sürümünün mü yoksa 64 bit sürümünün bu oturum yapılandırmasını kullanan oturumlarda mı başlatıldığını belirler. Bu parametre için kabul edilebilir değerler şunlardır: x86 (32 bit) ve AMD64 (64 bit). Varsayılan değer, oturum yapılandırmasını barındıran bilgisayarın işlemci mimarisi tarafından belirlenir.

64 bit bilgisayarda 32 bit oturum oluşturmak için bu parametreyi kullanabilirsiniz. 32 bit bilgisayarda 64 bit işlem oluşturma girişimleri başarısız olur.

Parametre özellikleri

Tür:String
Default value:None
Kabul edilen değerler:x86, amd64
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Pensilvanya

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

-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 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 Yürütme (Çağırma) izni olmalıdır.

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

Bu parametreyi atlarsanız, bu yapılandırma için WinRM hizmeti için kök SDDL kullanılır. Kök SDDL'yi görüntülemek veya değiştirmek için WSMan sağlayıcısını kullanın. Örneğin Get-Item WSMan:\localhost\service\rootSDDL. WSMan sağlayıcısı hakkında daha fazla bilgi için Get-Help WSManyazın.

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 seçenekler ( örneğin New-PSSessionOption cmdlet'ini kullanarak), 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 cmdlet'in oturum yapılandırması için SDDL oluşturmanıza yardımcı olan bir özellik sayfası görüntülediğini gösterir. özellik sayfası, komutunu girip winrm hizmetini yeniden başlattıktan sonra görüntülenir.

Yapılandırma izinlerini ayarlarken, bir oturumda oturum yapılandırmasını kullanmak için kullanıcıların en az Yürütme (Çağırma) 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

PowerShell betiğinin tam yolunu belirtir. Belirtilen betik, oturum yapılandırmasını kullanan yeni oturumda çalışır.

Betiği kullanarak oturumu ek olarak yapılandırabilirsiniz. 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:

  • Bilinmiyor
  • MTA
  • STA

Parametre özellikleri

Tür:ApartmentState
Default value:None
Kabul edilen değerler:STA, MTA, Unknown
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

Oturumda bir komut çalıştırıldığında iş parçacıklarının nasıl oluşturulup kullanılacağını belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • Varsayılan
  • ReuseThread (Yeniden Kullanım İpliği)
  • UseCurrentThread
  • UseNewThread

Varsayılan değer UseCurrentThreaddeğeridir.

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

Aktarım seçeneğini belirtir.

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ılmıyor.

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

WSManConfigContainerElement

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şlatmanız gerekir.

Bu cmdlet, Yönetim için Web Hizmetleri (WS-Management) eklenti yapılandırmasını temsil eden XML oluşturur ve YEREL bilgisayara eklentiyi kaydeden WS-Management'a XML gönderir (New-Item WSMan:\localhost\plugin).

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.