Register-PSSessionConfiguration

Sözdizimi

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

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

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

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

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

İlişkili Bağlantılar

• Disable-PSSessionConfiguration
• Enable-PSSessionConfiguration
• Get-PSSessionConfiguration
• New-PSSessionConfigurationFile
• Set-PSSessionConfiguration
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• WSMan Sağlayıcısı
• about_Session_Configurations
• about_Session_Configuration_Files