Set-PSSessionConfiguration

구문

Set-PSSessionConfiguration
   [-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>]

Set-PSSessionConfiguration
   [-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>]

Set-PSSessionConfiguration
   [-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

Set-PSSessionConfiguration cmdlet은 로컬 컴퓨터에서 세션 구성의 속성을 변경합니다.

Name 매개 변수를 사용하여 변경하려는 세션 구성을 식별합니다. 다른 매개 변수를 사용하여 세션 구성의 속성에 대한 새 값을 지정합니다. 구성에서 속성 값을 삭제하고 기본값을 사용하려면 해당 매개 변수에 대해 빈 문자열("") 또는 $Null 값을 입력합니다.

PowerShell 3.0부터 세션 구성 파일을 사용하여 세션 구성을 정의할 수 있습니다. 이 기능은 세션 구성을 사용하는 세션의 속성을 설정하고 변경하는 간단하고 검색 가능한 방법을 제공합니다. 세션 구성 파일을 지정하려면 Set-PSSessionConfigurationPath 매개 변수를 사용합니다. 세션 구성 파일에 대한 자세한 내용은 about_Session_Configuration_Files참조하세요. 세션 구성 파일을 만들고 수정하는 방법에 대한 자세한 내용은 New-PSSessionConfigurationFile cmdlet을 참조하세요.

세션 구성은 로컬 컴퓨터에 연결하는 원격 세션(PSSessions)의 환경을 정의합니다. 모든 PSSession 세션 구성을 사용합니다. 세션 구성은 세션에서 사용할 수 있는 모듈, 실행할 수 있는 cmdlet, 언어 모드, 할당량 및 시간 제한과 같은 PSSession기능을 결정합니다. 세션 구성의 보안 설명자는 세션 구성을 사용하여 로컬 컴퓨터에 연결할 수 있는 사용자를 결정합니다. 세션 구성에 대한 자세한 내용은 about_Session_Configurations참조하세요.

세션 구성의 속성을 보려면 Get-PSSessionConfiguration cmdlet 또는 WSMan 공급자를 사용합니다. WSMan 공급자에 대한 자세한 내용은 Get-Help WSMan입력합니다.

예제

예제 1: 스레드 아파트 상태 변경

PS C:\> Set-PSSessionConfiguration -Name "MaintenanceShell" -ThreadApartmentState STA

이 명령은 MaintenanceShell 구성의 스레드 아파트 상태를 STA로 변경합니다. 이 변경은 WinRM 서비스를 다시 시작할 때 적용됩니다.

예제 2: 세션 구성 만들기 및 변경

이 예제에서는 구성에서 시작 스크립트를 추가하고 제거하는 방법을 보여줍니다.

첫 번째 명령은 AdminShell 구성을 만듭니다. 두 번째 명령은 구성에 AdminConfig.ps1 스크립트를 추가합니다. 이 변경 내용은 WinRM다시 시작할 때 적용됩니다. 세 번째 명령은 구성에서 AdminConfig.ps1 스크립트를 제거합니다.

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $Null

예제 3: 결과 표시

다음은 MaximumReceivedObjectSizeMB 속성의 값을 20으로 늘리는 예제입니다. 또한 이 명령은 WinRM 서비스를 다시 시작하라는 메시지를 표시합니다. 이 변경은 WinRM 서비스가 다시 시작될 때까지 적용되지 않습니다.

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

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

ParamName                       ParamValue
---------                       ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

예제 4: 다양한 방법으로 결과 표시

이 예제에서는 Set-PSSessionConfigurationMaintenanceShell 세션 구성의 시작 스크립트를 Maintenance.ps1변경합니다. 출력은 변경 사항을 표시하고 WinRM 서비스를 다시 시작하라는 메시지를 표시합니다. 응답은 "y"(예)입니다.

Get-PSSessionConfiguration MaintenanceShell 세션 구성을 가져옵니다. 파이프라인 연산자(|)는 명령 결과를 Format-List보냅니다. 그러면 구성 개체의 모든 속성이 목록에 표시됩니다. 다음으로 WSMan 공급자를 사용하여 MaintenanceShell 구성에 대한 초기화 매개 변수를 확인합니다. Get-ChildItem(별칭 dir)는 MaintenanceShell 플러그 인에 대한 InitializationParameters 노드의 자식 항목을 가져옵니다. WSMan 공급자에 대한 자세한 내용은 Get-Help wsman입력합니다.

PS> Set-PSSessionConfiguration -Name "MaintenanceShell" -StartupScript "C:\ps-test\Maintenance.ps1"

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

ParamName            ParamValue
---------            ----------
startupscript        c:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run
the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

PS> Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name             : MaintenanceShell
Filename         : %windir%\system32\pwrshplugin.dll
SDKVersion       : 1
XmlRenderingType : text
lang             : en-US
PSVersion        : 2.0
startupscript    : c:\ps-test\Maintenance.ps1
ResourceUri      : https://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

PS> dir WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName     ParamValue
---------     ----------
PSVersion     2.0
startupscript c:\ps-test\Maintenance.ps1

매개 변수

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

입력

None

이 cmdlet에 입력을 파이프할 수 없습니다.

출력

WSManConfigLeafElement

참고

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

Set-PSSessionConfiguration cmdlet은 구성 이름을 변경하지 않으며 WSMan 공급자는 Rename-Item cmdlet을 지원하지 않습니다. 세션 구성의 이름을 변경하려면 Unregister-PSSessionConfiguration cmdlet을 사용하여 구성을 삭제한 다음 Register-PSSessionConfiguration cmdlet을 사용하여 새 세션 구성을 만들고 등록합니다.

Set-PSSessionConfiguration cmdlet을 사용하여 기본 Microsoft.PowerShell 및 Microsoft.PowerShell32 세션 구성을 변경할 수 있습니다. 보호되지 않습니다. 기본 세션 구성의 원래 버전으로 되돌리려면 Unregister-PSSessionConfiguration cmdlet을 사용하여 기본 세션 구성을 삭제한 다음 Enable-PSRemoting cmdlet을 사용하여 복원합니다.

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

WSMan: 드라이브의 명령을 사용하여 세션 구성의 속성을 변경할 수 있습니다. 그러나 PowerShell 2.0의 WSMan: 드라이브를 사용하여 OutputBufferingMode같은 PowerShell 3.0에 도입된 세션 구성 속성을 변경할 수 없습니다. Windows PowerShell 2.0 명령은 오류를 생성하지 않지만 효과가 없습니다. PowerShell 3.0에 도입된 속성을 변경하려면 PowerShell 3.0에서 WSMan: 드라이브를 사용합니다.

관련 링크

• Disable-PSSessionConfiguration
• Enable-PSSessionConfiguration
• Get-PSSessionConfiguration
• New-PSSessionConfigurationFile
• New-PSSessionOption
• New-PSTransportOption
• New-PSWorkflowExecutionOption
• Register-PSSessionConfiguration
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• WSMan 공급자
• about_Session_Configurations
• about_Session_Configuration_Files