Register-PSSessionConfiguration

Başvuru

Modül:: Microsoft.PowerShell.Core

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

Syntax

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

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

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

Register-PSSessionConfiguration Cmdlet, 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 yazın New-PSSession -ConfigurationName newshell.

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

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

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

Kullanıcı bir New-PSSession komut kullanıp MaintenanceShell yapılandırmasını seçtiğindeMaintenance.ps1, betik 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 New-PSSession oluşturursa, komut başarısız olur.

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

Bu örnek, Yönetici Shell 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. Komutu, Register-PSSessionConfiguration değişkenin değerinde $sddl SDDL'yi belirtmek için SecurityDescritorSDDL 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-PSSessionConfigurationdeğişkeninde $s depolanan bir WSManConfigContainerElement 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) yoldaki WSMan:\LocalHost\PlugIn öğ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, kullanıcının CurrentUserAllHosts profilini oturumun geçerli kapsamında ç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 parametrenin kabul edilebilir değerleri şunlardır:

Devre dışı. Oturum yapılandırmasını devre dışı bırakır. Bilgisayara uzaktan 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 tüm oturum yapılandırmalarına uzaktan erişim sağlar, Enable-PSSessionConfiguration cmdlet oturum yapılandırmalarını etkinleştirir ve Disable-PSRemoting cmdlet tüm oturum yapılandırmalarına uzaktan erişimi engeller.

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

Type:	PSSessionConfigurationAccessMode
Accepted values:	Disabled, Local, Remote
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationBase

AssemblyName parametresinin değerinde belirtilen derleme dosyasının (*.dll) yolunu belirtir. AssemblyName parametresinin değeri bir yol içermediğinde bu parametreyi kullanın. Geçerli dizin varsayılandır.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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ün System.Management.Automation.Remoting.PSSessionConfiguration sınıfını uygulaması gerekir.

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

Tür oluşturmak, bazı cmdlet parametrelerini ortaya çıkarma veya gizleme ya da kullanıcıların geçersiz kılamayacağı veri boyutu ve nesne boyutu sınırları ayarlama gibi oturum yapılandırmasının 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.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 belirtin.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[Double]
Position:	Named
Default value:	50
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[Double]
Position:	Named
Default value:	10
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 içeri 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ındaki ModulesToImport anahtarında listelenen modüllere (New-PSSessionConfigurationFile ) 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.

Type:	Object[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoServiceRestart

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

Varsayılan olarak, bir Register-PSSessionConfiguration komut ç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 cmdlet'ini Restart-Service kullanın.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

tarafından New-PSSessionConfigurationFileoluş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.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Aliases:	PA
Accepted values:	x86, amd64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Version
Aliases:	PowerShellVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 yazın Get-Help wsman.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionType

Oturum yapılandırması kullanılarak oluşturulan oturum türünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

Boş. Oturuma varsayılan olarak hiçbir modül eklenmez. Oturuma modüller, işlevler, betikler ve diğer özellikleri eklemek için bu cmdlet'in parametrelerini kullanın.
Varsayılan. Oturuma Microsoft.PowerShell.Core ekler. Bu modül, Import-Module cmdlet'i açıkça yasaklamadığınız sürece kullanıcıların diğer modülleri içeri aktarmak için kullanabileceği cmdlet'i içerir.
RestrictedRemoteServer. Yalnızca şu cmdlet'leri içerir: Exit-PSSession, Get-Command, Get-FormatData, Get-Help, Measure-Object, , Out-Defaultve Select-Object. Oturuma modüller, işlevler, betikler ve diğer özellikleri eklemek için bir betik veya derleme ya da oturum yapılandırma dosyasındaki anahtarları kullanın.

Varsayılan değer Varsayılan'dır.

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

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

Type:	PSSessionType
Accepted values:	DefaultRemoteShell, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 seçenekler (örneğin, cmdlet'ini New-PSSessionOption 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.

Type:	PSSessionTypeOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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ı, komutu girip Register-PSSessionConfiguration 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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 komut başarısız olur.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThreadApartmentState

Oturumdaki iş parçacıklarının daire durumunu belirtir. Bu parametre için kabul edilebilir değerler şunlardır: STA, MTA ve Bilinmiyor. Varsayılan değer Bilinmiyor'dur.

Type:	ApartmentState
Accepted values:	STA, MTA, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 parametrenin kabul edilebilir değerleri şunlardır:

Varsayılan
ReuseThread
UseCurrentThread
UseNewThread

Varsayılan değer UseCurrentThread'tir.

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

Type:	PSThreadOptions
Accepted values:	Default, UseNewThread, ReuseThread, UseCurrentThread
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TransportOption

Aktarım seçeneğini belirtir.

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

Type:	PSTransportOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

WSManConfigContainerElement

Notlar

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 XML'yi WS-Management'a gönderir ve eklentiyi yerel bilgisayara (New-Item wsman:\localhost\plugin ) kaydeder.

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.

Register-PSSessionConfiguration

Syntax

Description

Örnekler

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

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

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

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

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

Parametreler

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionType

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Register-PSSessionConfiguration

Syntax

Description

Örnekler

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

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

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

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

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

Parametreler

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionType

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar