New-PSSessionOption

Syntax

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

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

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

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

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

예제

예제 1: 기본 세션 옵션 Create

이 명령은 기본값을 사용하여 SessionOption 개체를 만듭니다.

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: 세션 옵션 개체를 사용하여 세션 구성

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

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

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

예제 3: 대화형 세션 시작

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

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

SessionOption 매개 변수의 값은 NoEncryption 및 NoCompression 매개 변수가 있는 명령입니다New-PSSessionOption.

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

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

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

$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: 기본 설정 변수 Create

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

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

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

모든 세션에서 변수를 $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

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

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

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

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

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

$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 및 Use라는 두 개의 키가 있는 해시 테이블을 만듭니다. 명령은 변수에 해시 테이블을 $team 저장합니다. 해시 테이블에 대한 자세한 내용은 about_Hash_Tables를 참조하세요.

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

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

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

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

매개 변수

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

PSSessionOption

참고

PSSession을 만들기 위해 명령에서 SessionOption 매개 변수를 사용하지 않는 경우 설정되는 경우 세션 옵션은 기본 설정 변수의 $PSSessionOption 속성 값에 따라 결정됩니다. 변수에 $PSSessionOption 대한 자세한 내용은 about_Preference_Variables.

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

관련 링크

• Enter-PSSession
• Invoke-Command
• New-PSSession