New-PSSessionOption

참조

모듈:: Microsoft.PowerShell.Core

PSSession에 대한 고급 옵션이 포함된 개체를 만듭니다.

구문

New-PSSessionOption
   [-MaximumRedirection <Int32>]
   [-NoCompression]
   [-NoMachineProfile]
   [-Culture <CultureInfo>]
   [-UICulture <CultureInfo>]
   [-MaximumReceivedDataSizePerCommand <Int32>]
   [-MaximumReceivedObjectSize <Int32>]
   [-OutputBufferingMode <OutputBufferingMode>]
   [-MaxConnectionRetryCount <Int32>]
   [-ApplicationArguments <PSPrimitiveDictionary>]
   [-OpenTimeout <Int32>]
   [-CancelTimeout <Int32>]
   [-IdleTimeout <Int32>]
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <AuthenticationMechanism>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [-IncludePortInSPN]
   [<CommonParameters>]

Description

New-PSSessionOption cmdlet은 사용자 관리 세션(PSSession)에 대한 고급 옵션이 포함된 개체를 만듭니다. New-PSSession, Enter-PSSession 및 Invoke-Command와 같은 PSSession만드는 cmdlet의 SessionOption 매개 변수 값으로 개체를 사용할 수 있습니다.

매개 변수가 없으면 New-PSSessionOption 모든 옵션에 대한 기본값이 포함된 개체를 생성합니다. 모든 속성을 편집할 수 있으므로 결과 개체를 템플릿으로 사용하고 엔터프라이즈에 대한 표준 옵션 개체를 만들 수 있습니다.

$PSSessionOption 기본 설정 변수에 세션 옵션 개체를 저장할 수도 있습니다. 이 변수의 값은 세션 옵션에 대한 새 기본값을 설정합니다. 세션에 대해 설정된 세션 옵션이 없고 세션 구성에서 설정된 옵션보다 우선하지만 세션을 만드는 cmdlet에서 세션 옵션 또는 세션 옵션 개체를 지정하여 재정의할 수 있습니다. $PSSessionOption 기본 설정 변수에 대한 자세한 내용은 about_Preference_Variables참조하세요.

세션을 만드는 cmdlet에서 세션 옵션 개체를 사용하는 경우 세션 옵션 값이 $PSSessionOption 기본 설정 변수 및 세션 구성에서 설정된 세션의 기본값보다 우선합니다. 그러나 세션 구성에 설정된 최대 값, 할당량 또는 제한보다 우선하지 않습니다. 세션 구성에 대한 자세한 내용은 about_Session_Configurations참조하세요.

예제

예제 1: 기본 세션 옵션 만들기

이 명령은 모든 기본값이 있는 세션 옵션 개체를 만듭니다.

New-PSSessionOption

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

예제 2: 세션 옵션 개체를 사용하여 세션 구성

이 예제에서는 세션 옵션 개체를 사용하여 세션을 구성하는 방법을 보여줍니다.

$pso = New-PSSessionOption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB
New-PSSession -ComputerName Server01 -SessionOption $pso

첫 번째 명령은 새 세션 옵션 개체를 만들고 $pso 변수의 값에 저장합니다. 두 번째 명령은 New-PSSession cmdlet을 사용하여 Server01 원격 컴퓨터에서 세션을 만듭니다. 이 명령은 $pso 변수 값의 세션 옵션 개체를 명령의 SessionOption 매개 변수 값으로 사용합니다.

예제 3: 대화형 세션 시작

이 명령은 Enter-PSSession cmdlet을 사용하여 Server01 컴퓨터와 대화형 세션을 시작합니다.

Enter-PSSession -ComputerName Server01 -SessionOption (New-PSSessionOption -NoEncryption -NoCompression)

SessionOption 매개 변수의 값은 NoEncryption 및 noCompression 매개 변수를 명령입니다.

New-PSSessionOption 명령은 괄호로 묶어 Enter-PSSession 명령 전에 실행되도록 합니다.

예제 4: 세션 옵션 개체 수정

이 예제에서는 세션 옵션 개체를 수정할 수 있음을 보여 줍니다. 모든 속성에는 읽기/쓰기 값이 있습니다.

$a = New-PSSessionOption
$a.OpenTimeout

Days              : 0
Hours             : 0
Minutes           : 3
Seconds           : 0
Milliseconds      : 0
Ticks             : 1800000000
TotalDays         : 0.00208333333333333
TotalHours        : 0.05
TotalMinutes      : 3
TotalSeconds      : 180
TotalMilliseconds : 180000

$a.UICulture = (Get-UICulture)
$a.OpenTimeout = (New-Timespan -Minutes 4)
$a.MaximumConnectionRedirectionCount = 1
$a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

이 메서드를 사용하여 엔터프라이즈에 대한 표준 세션 개체를 만든 다음, 특정 용도로 사용자 지정된 버전을 만듭니다.

예제 5: 기본 설정 변수 만들기

이 명령은 $PSSessionOption 기본 설정 변수를 만듭니다.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

세션에서 $PSSessionOption 기본 설정 변수가 발생하면 New-PSSession, Enter-PSSession및 Invoke-Command cmdlet을 사용하여 만든 세션의 옵션에 대한 기본값을 설정합니다.

모든 세션에서 $PSSessionOption 변수를 사용할 수 있도록 하려면 PowerShell 세션 및 PowerShell 프로필에 추가합니다.

$PSSessionOption 기본 설정 변수에 대한 자세한 내용은 about_Preference_Variables참조하세요. 프로필에 대한 자세한 내용은 about_Profiles참조하세요.

예제 6: 원격 세션 구성에 대한 요구 사항 충족

이 예제에서는 SessionOption 개체를 사용하여 원격 세션 구성에 대한 요구 사항을 충족하는 방법을 보여 줍니다.

$skipCN = New-PSSessionOption -SkipCNCheck
New-PSSession -ComputerName 171.09.21.207 -UseSSL -Credential Domain01\User01 -SessionOption $SkipCN

첫 번째 명령은 New-PSSessionOption cmdlet을 사용하여 SkipCNCheck 속성이 있는 세션 옵션 개체를 만듭니다. 이 명령은 결과 세션 개체를 $skipCN 변수에 저장합니다.

두 번째 명령은 New-PSSession cmdlet을 사용하여 원격 컴퓨터에 새 세션을 만듭니다. $skipCN 검사 변수는 SessionOption 매개 변수의 값에 사용됩니다.

컴퓨터가 IP 주소로 식별되므로 ComputerName 매개 변수 값이 SSL(Secure Sockets Layer)에 사용되는 인증서의 일반 이름과 일치하지 않습니다. 따라서 SkipCNCheck 옵션이 필요합니다.

예제 7: 원격 세션에서 인수를 사용할 수 있도록 설정

이 예제에서는 New-PSSessionOption cmdlet의 ApplicationArguments 매개 변수를 사용하여 원격 세션에서 추가 데이터를 사용할 수 있도록 하는 방법을 보여 줍니다.

$team = @{Team="IT"; Use="Testing"}
$TeamOption = New-PSSessionOption -ApplicationArguments $team
$s = New-PSSession -ComputerName Server01 -SessionOption $TeamOption
Invoke-Command -Session $s {$PSSenderInfo.ApplicationArguments}

Name                 Value
----                 -----
Team                 IT
Use                  Testing
PSVersionTable       {CLRVersion, BuildVersion, PSVersion, WSManStackVersion...}

Invoke-Command -Session $s {
  if ($PSSenderInfo.ApplicationArguments.Use -ne "Testing") {
    .\logFiles.ps1
  }
  else {
    "Just testing."
  }
}

Just testing.

첫 번째 명령은 Team 사용하는 두 개의 키가 있는 해시 테이블을 만듭니다. 이 명령은 해시 테이블을 $team 변수에 저장합니다. 해시 테이블에 대한 자세한 내용은 about_Hash_Tables참조하세요.

다음으로 New-PSSessionOption cmdlet은 ApplicationArguments 매개 변수를 사용하여 $team 변수에 저장된 세션 옵션 개체를 만듭니다. New-PSSessionOption 세션 옵션 개체를 만들 때 데이터를 원격 세션으로 안정적으로 전송할 수 있도록 ApplicationArguments 매개 변수 값의 해시 테이블을 기본 사전으로 자동으로 변환합니다.

New-PSSession cmdlet은 Server01 컴퓨터에서 세션을 시작합니다. SessionOption 매개 변수를 사용하여 $teamOption 변수에 옵션을 포함합니다.

Invoke-Command cmdlet은 $team 변수의 데이터를 원격 세션의 명령에 사용할 수 있음을 보여 줍니다. 데이터는 $PSSenderInfo 자동 변수의 ApplicationArguments 속성에 나타납니다.

마지막 Invoke-Command 데이터를 사용하는 방법을 보여줍니다.

매개 변수

-ApplicationArguments

원격 세션으로 전송되는 기본 사전을 지정합니다. 세션 구성의 시작 스크립트를 포함하여 원격 세션의 명령 및 스크립트는 $PSSenderInfo 자동 변수의 ApplicationArguments 속성에서 이 사전을 찾을 수 있습니다. 이 매개 변수를 사용하여 원격 세션으로 데이터를 보낼 수 있습니다.

자세한 내용은 about_Hash_Tables, about_Session_Configurations및 about_Automatic_Variables참조하세요.

형식:	PSPrimitiveDictionary
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CancelTimeout

PowerShell에서 취소 작업(CTRL+C)이 완료되기를 기다리는 시간을 결정합니다. 값을 밀리초 단위로 입력합니다.

기본값은 60000(1분)입니다. 값이 0이면 시간 제한 없음을 의미합니다. 명령은 무기한으로 계속됩니다.

형식:	Int32
별칭:	CancelTimeoutMSec
Position:	Named
Default value:	60000
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Culture

세션에 사용할 문화권을 지정합니다. 문화권 이름을 <languagecode2>-<country/regioncode2> 형식(예: ja-JP), CultureInfo 개체를 포함하는 변수 또는 CultureInfo 개체를 가져오는 명령을 입력합니다.

기본값은 $Null운영 체제에 설정된 문화권이 세션에서 사용됩니다.

형식:	CultureInfo
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IdleTimeout

원격 컴퓨터가 로컬 컴퓨터에서 통신을 받지 못하는 경우 세션이 열린 상태로 유지되는 기간을 결정합니다. 여기에는 하트비트 신호가 포함됩니다. 간격이 만료되면 세션이 닫힙니다.

세션의 연결을 끊고 다시 연결하려는 경우 유휴 시간 제한 값은 매우 중요합니다. 세션 시간이 초과되지 않은 경우에만 다시 연결할 수 있습니다.

값을 밀리초 단위로 입력합니다. 최소값은 60000(1분)입니다. 최대값은 세션 구성의 MaxIdleTimeoutms 속성 값입니다. 기본값인 -1은 유휴 시간 초과를 설정하지 않습니다.

세션은 세션 옵션에 설정된 유휴 시간 제한(있는 경우)을 사용합니다. 설정되지 않은 경우(-1) 세션은 세션 구성의 IdleTimeoutMs 속성 또는 WSMan 셸 제한 시간 값(WSMan:\<ComputerName>\Shell\IdleTimeout) 중 가장 짧은 값을 사용합니다.

세션 옵션에 설정된 유휴 시간 제한이 세션 구성의 MaxIdleTimeoutMs 속성 값을 초과하면 세션을 만드는 명령이 실패합니다.

기본 Microsoft.PowerShell 세션 구성의 IdleTimeoutMs 값은 7200000밀리초(2시간)입니다. 해당 MaxIdleTimeoutMs 값은 2147483647 밀리초(>24일)입니다. WSMan 셸 유휴 시간 제한(WSMan:\<ComputerName>\Shell\IdleTimeout)의 기본값은 7200000밀리초(2시간)입니다.

세션에서 연결을 끊거나 세션에 다시 연결할 때 세션의 유휴 시간 제한 값을 변경할 수도 있습니다. 자세한 내용은 Disconnect-PSSession 및 Connect-PSSession참조하세요.

Windows PowerShell 2.0에서 IdleTimeout 매개 변수의 기본값은 240000(4분)입니다.

형식:	Int32
별칭:	IdleTimeoutMSec
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IncludePortInSPN

Kerberos 인증에 사용되는 SPN(서비스 사용자 이름)에 포트 번호를 포함합니다(예: HTTP://<ComputerName>:5985). 이 옵션을 사용하면 기본이 아닌 SPN을 사용하는 클라이언트가 Kerberos 인증을 사용하는 원격 컴퓨터에 대해 인증할 수 있습니다.

이 옵션은 Kerberos 인증을 지원하는 여러 서비스가 다른 사용자 계정으로 실행되는 엔터프라이즈용으로 설계되었습니다. 예를 들어 Kerberos 인증을 허용하는 IIS 애플리케이션은 컴퓨터 계정과 다른 사용자 계정에 기본 SPN을 등록해야 할 수 있습니다. 이러한 경우 PowerShell 원격은 컴퓨터 계정에 등록된 SPN이 필요하기 때문에 Kerberos를 사용하여 인증할 수 없습니다. 이 문제를 해결하기 위해 관리자는 다른 사용자 계정에 등록되고 SPN에 포트 번호를 포함하여 구분할 수 있는 Setspn.exe사용하는 등 다양한 SPN을 만들 수 있습니다.

자세한 내용은 Setspn 개요참조하세요.

이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaxConnectionRetryCount

네트워크 문제로 인해 현재 시도가 실패하는 경우 PowerShell에서 대상 컴퓨터에 연결을 시도하는 횟수를 지정합니다. 기본값은 5입니다.

이 매개 변수는 PowerShell 버전 5.0에 대해 추가되었습니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaximumReceivedDataSizePerCommand

로컬 컴퓨터가 원격 컴퓨터에서 단일 명령으로 받을 수 있는 최대 바이트 수를 지정합니다. 값을 바이트 단위로 입력합니다. 기본적으로 데이터 크기 제한은 없습니다.

이 옵션은 클라이언트 컴퓨터의 리소스를 보호하도록 설계되었습니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaximumReceivedObjectSize

로컬 컴퓨터가 원격 컴퓨터에서 받을 수 있는 개체의 최대 크기를 지정합니다. 이 옵션은 클라이언트 컴퓨터의 리소스를 보호하도록 설계되었습니다. 값을 바이트 단위로 입력합니다.

Windows PowerShell 2.0에서 이 매개 변수를 생략하면 개체 크기 제한이 없습니다. Windows PowerShell 3.0부터 이 매개 변수를 생략하면 기본값은 200MB입니다.

형식:	Int32
Position:	Named
Default value:	200 MB
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaximumRedirection

연결이 실패하기 전에 PowerShell이 대체 URI(Uniform Resource Identifier)로 연결을 리디렉션하는 횟수를 결정합니다. 기본값은 5입니다. 값이 0이면 모든 리디렉션이 방지됩니다.

이 옵션은 세션을 만드는 명령에서 AllowRedirection 매개 변수를 사용하는 경우에만 세션에서 사용됩니다.

형식:	Int32
Position:	Named
Default value:	5
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoCompression

세션에서 패킷 압축을 해제합니다. 압축은 더 많은 프로세서 주기를 사용하지만 전송 속도가 빨라집니다.

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoEncryption

데이터 암호화를 해제합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoMachineProfile

사용자의 Windows 사용자 프로필 로드를 방지합니다. 따라서 세션이 더 빠르게 만들어질 수 있지만 사용자별 레지스트리 설정, 환경 변수 및 인증서와 같은 항목은 세션에서 사용할 수 없습니다.

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OpenTimeout

클라이언트 컴퓨터가 세션 연결이 설정될 때까지 대기하는 시간을 결정합니다. 간격이 만료되면 연결을 설정하는 명령이 실패합니다. 값을 밀리초 단위로 입력합니다.

기본값은 180000(3분)입니다. 값이 0이면 시간 제한 없음을 의미합니다. 명령은 무기한으로 계속됩니다.

형식:	Int32
별칭:	OpenTimeoutMSec
Position:	Named
Default value:	180000 (3 minutes)
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OperationTimeout

세션의 모든 작업을 실행할 수 있는 최대 시간을 결정합니다. 간격이 만료되면 작업이 실패합니다. 값을 밀리초 단위로 입력합니다.

기본값은 180000(3분)입니다. 값이 0이면 시간 제한 없음을 의미합니다. 작업은 무기한으로 계속됩니다.

형식:	Int32
별칭:	OperationTimeoutMSec
Position:	Named
Default value:	180000 (3 minutes)
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OutputBufferingMode

출력 버퍼가 가득 차면 연결이 끊긴 세션에서 명령 출력을 관리하는 방법을 결정합니다.

세션 또는 세션 구성에서 출력 버퍼링 모드가 설정되지 않은 경우 기본값은 블록. 사용자는 세션 연결을 끊을 때 출력 버퍼링 모드를 변경할 수도 있습니다.

이 매개 변수를 생략하면 세션 옵션 개체의 OutputBufferingMode 값은 None입니다. 블록 또는 삭제 값은 세션 구성에 설정된 출력 버퍼링 모드 전송 옵션을 재정의합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

차단. 출력 버퍼가 가득 차면 버퍼가 명확할 때까지 실행이 일시 중단됩니다.
방울. 출력 버퍼가 가득 차면 실행이 계속됩니다. 새 출력이 저장되면 가장 오래된 출력이 삭제됩니다.
없음. 출력 버퍼링 모드가 지정되지 않았습니다.

출력 버퍼링 모드 전송 옵션에 대한 자세한 내용은 New-PSTransportOption참조하세요.

이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.

형식:	OutputBufferingMode
허용되는 값:	None, Drop, Block
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProxyAccessType

호스트 이름을 확인하는 데 사용되는 메커니즘을 결정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

IEConfig
WinHttpConfig
자동 검색
NoProxyServer
없음

기본값은 None입니다.

이 매개 변수의 값에 대한 자세한 내용은 ProxyAccessType 열거형참조하세요.

형식:	ProxyAccessType
허용되는 값:	None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProxyAuthentication

프록시 확인에 사용되는 인증 방법을 지정합니다. 이 매개 변수에 허용되는 값은 Basic, Digest및 negotiate입니다. 기본값은 negotiate.

이 매개 변수의 값에 대한 자세한 내용은 AuthenticationMechanism 열거형참조하세요.

형식:	AuthenticationMechanism
허용되는 값:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
Default value:	Negotiate
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProxyCredential

프록시 인증에 사용할 자격 증명을 지정합니다. PSCredential 개체 또는 Get-Credential 명령과 같은 PSCredential 개체를 가져오는 명령을 포함하는 변수를 입력합니다. 이 옵션을 설정하지 않으면 자격 증명이 지정되지 않습니다.

형식:	PSCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SkipCACheck

HTTPS를 통해 연결할 때 클라이언트는 서버 인증서가 신뢰할 수 있는 CA(인증 기관)에서 서명했는지 확인하지 않도록 지정합니다.

원격 컴퓨터가 물리적으로 안전하고 격리된 네트워크의 일부이거나 원격 컴퓨터가 WinRM 구성에서 신뢰할 수 있는 호스트로 나열되는 경우와 같이 다른 메커니즘을 사용하여 원격 컴퓨터를 신뢰할 수 있는 경우에만 이 옵션을 사용합니다.

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SkipCNCheck

서버의 인증서 CN(일반 이름)이 서버의 호스트 이름과 일치하지 않도록 지정합니다. 이 옵션은 HTTPS 프로토콜을 사용하는 원격 작업에서만 사용됩니다.

신뢰할 수 있는 컴퓨터에 대해서만 이 옵션을 사용합니다.

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SkipRevocationCheck

서버 인증서의 해지 상태의 유효성을 검사하지 않습니다.

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UICulture

세션에 사용할 UI 문화권을 지정합니다.

유효한 값은 다음과 같습니다.

ja-JP 같은 <languagecode2>-<country/regioncode2> 형식의 문화권 이름
CultureInfo 개체를 포함하는 변수
Get-Culture 같은 CultureInfo 개체를 가져오는 명령입니다.

기본값은 $null세션이 만들어지면 운영 체제에서 설정되는 UI 문화권이 세션에서 사용됩니다.

형식:	CultureInfo
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UseUTF16

이 cmdlet이 UTF8 형식 대신 UTF16 형식으로 요청을 인코딩한다는 것을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

None

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

출력

PSSessionOption

참고

SessionOption 매개 변수가 PSSession만드는 명령에 사용되지 않는 경우 세션 옵션은 설정된 경우 $PSSessionOption 기본 설정 변수의 속성 값에 따라 결정됩니다. $PSSessionOption 변수에 대한 자세한 내용은 about_Preference_Variables참조하세요.

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

다음을 통해 공유

New-PSSessionOption

구문

Description

예제

예제 1: 기본 세션 옵션 만들기

예제 2: 세션 옵션 개체를 사용하여 세션 구성

예제 3: 대화형 세션 시작

예제 4: 세션 옵션 개체 수정

예제 5: 기본 설정 변수 만들기

예제 6: 원격 세션 구성에 대한 요구 사항 충족

예제 7: 원격 세션에서 인수를 사용할 수 있도록 설정

매개 변수

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

입력

출력

참고

추가 리소스

다음을 통해 공유

New-PSSessionOption

구문

Description

예제

예제 1: 기본 세션 옵션 만들기

예제 2: 세션 옵션 개체를 사용하여 세션 구성

예제 3: 대화형 세션 시작

예제 4: 세션 옵션 개체 수정

예제 5: 기본 설정 변수 만들기

예제 6: 원격 세션 구성에 대한 요구 사항 충족

예제 7: 원격 세션에서 인수를 사용할 수 있도록 설정

매개 변수

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

입력

출력

참고

관련 링크

추가 리소스