Register-PSSessionConfiguration

Register-PSSessionConfiguration [-AssemblyName] <string> [-ConfigurationTypeName] <string> [-ApplicationBase <string>] [-Name] <string> [-Force] [-MaximumReceivedDataSizePerCommandMB <double>] [-MaximumReceivedObjectSizeMB <double>] [-NoServiceRestart] [-ProcessorArchitecture <string>] [-SecurityDescriptorSDDL <string>] [-ShowSecurityDescriptorUI] [-StartupScript <string>] [-ThreadApartmentState {<STA> | <MTA> | <Unknown>}] [-ThreadOptions {<Default> | <UseNewThread> | <ReuseThread> | <UseCurrentThread>}] [-Confirm] [-WhatIf] [<CommonParameters>]

C:\PS>register-pssessionConfiguration -name NewShell -applicationBase c:\MyShells\ -assemblyName MyShell.dll -configurationTypeName MyClass

설명
-----------
이 명령은 NewShell 세션 구성을 등록하며 ApplicationName 및 ApplicationBase 매개 변수를 사용하여 MyShell.dll 파일의 위치를 지정합니다. 이 파일은 세션 구성의 cmdlet과 공급자를 지정합니다. 또한 이 명령은 ConfigurationTypeName 매개 변수를 사용하여 세션을 추가로 구성하는 새 클래스를 지정합니다.

이 구성을 사용하기 위해 사용자는 "new-pssession -configurationname newshell"을 입력합니다.

C:\PS>register-pssessionConfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1

설명
-----------
이 명령은 MaintenanceShell 구성을 로컬 컴퓨터에 등록합니다. 또한 StartupScript 매개 변수를 사용하여 Maintenance.ps1 스크립트를 지정합니다.

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

C:\PS>$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FA;SA;GWGX;;WD)"

C:\PS> register-pssessionconfiguration -name AdminShell -securityDescriptorSDDL $sddl -maximumReceivedObjectSizeMB 20 -startupScript c:\scripts\AdminShell.ps1

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

첫 번째 명령은 사용자 지정 SDDL을 $sddl 변수에 저장합니다. 

두 번째 명령은 새 셸을 등록합니다. 이 명령은 SecurityDescritorSDDL 매개 변수를 사용하여 $sddl 변수의 값에 SDDL을 지정하고 MaximumReceivedObjectSizeMB 매개 변수를 사용하여 개체 크기 제한을 늘립니다. 또한 StartupScript 매개 변수를 사용하여 세션을 구성하는 스크립트를 지정합니다.

SecurityDescriptorSDDL 매개 변수를 사용하는 대신 세션 구성에 대한 사용 권한을 설정할 때 사용 가능한 속성 시트를 표시하는 ShowSecurityDescriptorUI 매개 변수를 사용할 수 있습니다. 속성 시트에서 "확인"을 클릭하면 세션 구성에 대한 SDDL이 생성됩니다.

C:\PS>$s = register-pssessionConfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1

C:\PS> $s

   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}


C:\PS> $s.getType().fullname
TypeName: Microsoft.WSMan.Management.WSManConfigContainerElement


C:\PS> $s | format-list -property *

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


C:\PS> dir wsman:\localhost\plugin

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

설명
-----------
이 예에서는 Register-PSSessionConfiguration 명령에서 WSManConfigContainerElement가 반환되는 것을 보여 줍니다. 또한 WSMan: 드라이브에서 컨테이너 요소를 찾는 방법을 보여 줍니다.

첫 번째 명령은 Register-PSSessionConfiguration cmdlet을 사용하여 MaintenanceShell 세션 구성을 등록합니다. 또한 cmdlet이 반환하는 개체를 $s 변수에 저장합니다.

두 번째 명령은 $s 변수의 내용을 표시합니다. 

세 번째 명령은 GetType 메서드와 해당 FullName 속성을 사용하여 Register-PSSessionConfiguration에서 반환되는 개체의 유형 이름을 표시합니다.

네 번째 명령은 Format-List cmdlet을 사용하여 Register-PSSessionConfiguration에서 반환되는 개체의 모든 속성을 목록으로 표시합니다. PSPath 속성은 개체가 WSMan: 드라이브의 디렉터리에 저장됨을 보여 줍니다.

다섯 번째 명령은 Get-ChildItem cmdlet을 사용하여 WSMan:\LocalHost\PlugIn 경로의 항목을 표시합니다. 이러한 항목에는 새로운 MaintenanceShell 구성 및 Windows PowerShell과 함께 제공되는 두 개의 기본 구성이 포함됩니다.

C:\PS>register-pssessionconfiguration -name WithProfile -startupScript add-profile.ps1

# Add-Profile.ps1

. c:\users\admin01\documents\windowspowershell\profile.ps1

설명
-----------
이 명령은 로컬 컴퓨터에서 WithProfile 세션 구성을 만들고 등록합니다. 또한 StartupScript 매개 변수를 사용하여 세션 구성을 사용하는 모든 세션에서 지정된 스크립트를 실행하도록 Windows PowerShell에 지정합니다.

지정된 스크립트인 Add-Profile.ps1의 내용도 표시됩니다. 스크립트에는 도트 소싱을 사용하여 현재 세션 범위에서 사용자의 CurrentUserAllHosts 프로필을 실행하는 단일 명령이 포함되어 있습니다.

프로필에 대한 자세한 내용은 about_Profiles를 참조하십시오. 도트 소싱에 대한 자세한 내용은 about_Scopes를 참조하십시오.