Register-PSSessionConfiguration

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

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

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

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

Register-PSSessionConfiguration cmdlet은 로컬 컴퓨터에 새 세션 구성을 만들고 등록합니다. 원격 사용자에 대한 사용자 지정 세션을 만드는 데 사용할 수 있는 고급 cmdlet입니다.

모든 PowerShell 세션(PSSession)은 엔드포인트라고도 하는 세션 구성을 사용합니다. 사용자가 컴퓨터에 연결하는 세션을 만들 때 세션 구성을 선택하거나 PowerShell 원격을 사용하도록 설정할 때 등록된 기본 세션 구성을 사용할 수 있습니다. 사용자는 현재 세션에서 만든 원격 세션에 대한 기본 구성을 지정하는 $PSSessionConfigurationName 기본 설정 변수를 설정할 수도 있습니다.

세션 구성은 원격 세션에 대한 환경을 정의합니다. 구성은 세션에서 사용할 수 있는 명령 및 언어 요소를 결정할 수 있으며, 세션이 단일 개체 또는 명령에서 원격으로 수신할 수 있는 데이터 양을 제한하는 설정과 같이 컴퓨터를 보호하는 설정을 포함할 수 있습니다. 세션 구성의 보안 설명자는 세션 구성을 사용할 수 있는 권한이 있는 사용자를 결정합니다.

새 구성 클래스를 구현하는 어셈블리를 사용하고 세션에서 실행되는 스크립트를 사용하여 구성 요소를 정의할 수 있습니다. PowerShell 3.0부터 세션 구성 파일을 사용하여 세션 구성을 정의할 수도 있습니다.

세션 구성에 대한 자세한 내용은 about_Session_Configurations참조하세요. 세션 구성 파일에 대한 자세한 내용은 about_Session_Configuration_Files참조하세요.

이 예제에서는 NewShell 세션 구성을 등록합니다. AssemblyName 및 ApplicationBase 매개 변수는 세션 구성에서 cmdlet 및 공급자를 지정하는 MyShell.dll 파일의 위치를 지정합니다. ConfigurationTypeName 매개 변수는 어셈블리에서 사용할 구성 클래스를 지정합니다.

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

이 구성을 사용하려면 New-PSSession -ConfigurationName NewShell입력합니다.

다음은 로컬 컴퓨터에서 MaintenanceShell 세션 구성을 등록하는 예제입니다. StartupScript 매개 변수는 Maintenance.ps1 스크립트를 지정합니다.

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

사용자가 New-PSSession 명령을 사용하고 MaintenanceShell 구성을 선택하면 Maintenance.ps1 스크립트가 새 세션에서 실행됩니다. 스크립트는 세션을 구성할 수 있습니다. 여기에는 모듈 가져오기 및 세션에 대한 실행 정책 설정이 포함됩니다. 스크립트가 종료되지 않는 오류를 포함하여 오류를 생성하는 경우 New-PSSession 명령이 실패합니다.

이 예제에서는 AdminShell 세션 구성을 등록합니다.

$sessionParams 변수는 모든 매개 변수 값을 포함하는 해시 테이블입니다. 이 해시 테이블은 PowerShell 스플래팅을 사용하여 cmdlet에 전달됩니다. Register-PSSessionConfiguration 명령은 SecurityDescriptorSDDL 매개 변수를 사용하여 $sddl 변수 값에 SDDL을 지정하고 MaximumReceivedObjectSizeMB 매개 변수를 사용하여 개체 크기 제한을 높입니다. 또한 StartupScript 매개 변수를 사용하여 세션을 구성하는 스크립트를 지정합니다.

$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

이 예제에서는 MaintenanceShell 구성을 등록하는 방법을 보여줍니다. Register-PSSessionConfiguration 변수에 저장된 $s 개체를 반환합니다. Format-List 반환된 개체의 모든 속성을 표시합니다. PSPath 속성은 개체가 WSMan: 드라이브의 디렉터리에 저장되어 있음을 보여 줍니다. Get-ChildItem(별칭 dir)은 WSMan:\LocalHost\PlugIn 경로에 항목을 표시합니다. 여기에는 새 MaintenanceShell 구성과 PowerShell과 함께 제공되는 두 가지 기본 구성이 포함됩니다.

$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}

이 예제에서는 WithProfile 세션 구성을 만들고 등록합니다. StartupScript 매개 변수는 PowerShell이 세션 구성을 사용하는 모든 세션에 대해 지정된 스크립트를 실행하도록 지시합니다.

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

스크립트에는 점 소싱을 사용하여 세션의 현재 범위에서 사용자의 CurrentUserAllHosts 프로필을 실행하는 단일 명령이 포함되어 있습니다.

프로필에 대한 자세한 내용은 about_Profiles참조하세요. 점 소싱에 대한 자세한 내용은 about_Scopes참조하세요.

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

개체를 이 cmdlet에 파이프로 연결할 수 없습니다.

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

이 cmdlet을 실행하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작해야 합니다.

이 cmdlet은 Web Services for Management(WS-Management) 플러그 인 구성을 나타내는 XML을 생성하고 로컬 컴퓨터(New-Item WSMan:\localhost\plugin)에 플러그 인을 등록하는 WS-Management에 XML을 보냅니다.

세션 구성 개체의 속성은 세션 구성에 대해 설정된 옵션 및 해당 옵션의 값에 따라 달라집니다. 또한 세션 구성 파일을 사용하는 세션 구성에는 추가 속성이 있습니다.