다음을 통해 공유

New-WSManSessionOption

  • 참조
모듈:
Microsoft.WSMan.Management

WS-Management cmdlet에 대한 입력 매개 변수로 사용할 세션 옵션 해시 테이블을 만듭니다.

구문

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

Description

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

이 cmdlet은 New-WSManSessionOption WSMan cmdlet에 전달할 수 있는 WSMan 세션 옵션 해시 테이블을 만듭니다.

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-WSMan

예제

예제 1: 연결 옵션을 사용하는 연결 만들기

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

이 예제에서는 정의한 연결 옵션을 New-WSManSessionOption사용하여 원격 server01 컴퓨터에 대한 연결을 만듭니다.

첫 번째 명령은 변수에 연결 설정 옵션 집합을 $a 저장하는 데 사용합니다New-WSManSessionOption. 이 경우 세션 옵션은 연결 시간을 30초(30,000밀리초)로 설정합니다.

두 번째 명령은 SessionOption 매개 변수를 사용하여 변수에 저장된 자격 증명을 $a 전달합니다Connect-WSMan. Connect-WSMan 그런 다음, 지정된 세션 옵션을 사용하여 원격 server01 컴퓨터에 연결합니다.

Connect-WSMan 는 일반적으로 WSMan 공급자의 컨텍스트에서 원격 컴퓨터(이 경우 server01 컴퓨터)에 연결하는 데 사용됩니다. 그러나 WSMan 공급자로 변경하기 전에 cmdlet을 사용하여 원격 컴퓨터에 대한 연결을 설정할 수 있습니다. 이러한 연결은 ComputerName 목록에 표시됩니다.

매개 변수

-NoEncryption

연결에서 HTTP를 통한 원격 작업에 암호화를 사용하지 않음을 나타냅니다.

기본적으로 암호화되지 않은 트래픽은 사용하도록 설정되지 않습니다. 로컬 구성에서 사용하도록 설정해야 합니다.

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

-OperationTimeout

WS-Management 작업에 대한 시간 제한(밀리초)을 지정합니다.

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

-ProxyAccessType

프록시 서버가 배치되는 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • ProxyIEConfig - 현재 사용자에 대해 Internet Explorer 프록시 구성을 사용합니다.
  • ProxyWinHttpConfig - WSMan 클라이언트는 ProxyCfg.exe 유틸리티를 사용하여 WinHTTP에 대해 구성된 프록시 설정을 사용합니다.
  • ProxyAutoDetect - 프록시 서버의 자동 검색을 강제 적용합니다.
  • ProxyNoProxyServer - 프록시 서버를 사용하지 마세요. 모든 호스트 이름을 로컬로 확인합니다.

기본값은 ProxyIEConfig입니다.

형식:ProxyAccessType
허용되는 값:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProxyAuthentication

프록시에 사용할 인증 방법을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Basic - 기본은 사용자 이름과 암호가 서버 또는 프록시에 지우기 텍스트로 전송되는 체계입니다.
  • Digest - 다이제스트는 챌린지에 서버 지정 데이터 문자열을 사용하는 챌린지-응답 체계입니다.
  • Negotiate - 협상은 인증에 사용할 체계를 결정하기 위해 서버 또는 프록시와 협상하는 챌린지 응답 체계입니다. 이러한 예로는 Kerberos 프로토콜 및 NTLM이 있습니다.

기본값은 Negotiate입니다.

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

-ProxyCredential

중간 웹 프록시를 통해 액세스 권한을 얻을 수 있는 사용자 계정을 지정합니다.

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

-SkipCACheck

HTTPS를 통해 연결할 때 클라이언트가 서버 인증서가 신뢰할 수 있는 CA(인증 기관)에서 서명했는지 확인하지 않도록 지정합니다. 원격 컴퓨터가 다른 방법으로 신뢰할 수 있는 경우에만 이 옵션을 사용합니다. 예를 들어 원격 컴퓨터가 물리적으로 안전하고 격리된 네트워크의 일부이거나 원격 컴퓨터가 WS-Management 구성에서 신뢰할 수 있는 호스트로 나열된 경우에만 사용합니다.

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

-SkipCNCheck

서버의 인증서 CN(일반 이름)이 서버의 호스트 이름과 일치하지 않도록 지정합니다. 이 옵션은 HTTPS를 사용하는 원격 작업에만 사용됩니다. 이 옵션은 신뢰할 수 있는 컴퓨터에만 사용해야 합니다.

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

-SkipRevocationCheck

연결이 서버 인증서의 해지 상태의 유효성을 검사하지 않음을 나타냅니다.

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

-SPNPort

원격 서버의 SPN(연결 서비스 사용자 이름)에 추가할 포트 번호를 지정합니다. SPN은 인증 메커니즘이 Kerberos 또는 Negotiate일 때 사용됩니다.

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

-UseUTF16

연결이 UTF8 형식 대신 UTF16 형식으로 요청을 인코딩한다는 것을 나타냅니다. 기본값은 UTF8 인코딩입니다.

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

출력

SessionOption

이 cmdlet은 생성된 WSMan 세션 옵션을 SessionOption 개체로 반환합니다.