다음을 통해 공유

New-CimSession

  • 참조
모듈:
CimCmdlets

CIM 세션을 만듭니다.

구문

New-CimSession
   [-Authentication <PasswordAuthenticationMechanism>]
   [[-Credential] <PSCredential>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]
New-CimSession
   [-CertificateThumbprint <String>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]

Description

cmdlet은 New-CimSession CIM 세션을 만듭니다. CIM 세션은 로컬 컴퓨터 또는 원격 컴퓨터에 대한 연결을 나타내는 클라이언트 쪽 개체입니다. CIM 세션에는 ComputerName, 사용된 프로토콜 또는 다양한 식별자와 같은 연결에 대한 정보가 포함됩니다.

이 cmdlet은 다른 모든 CIM cmdlet에서 사용할 수 있는 CIM 세션 개체를 반환합니다.

예제

예제 1: 기본 옵션을 사용하여 CIM 세션 만들기

이 예제에서는 기본 옵션을 사용하여 로컬 CIM 세션을 만듭니다. ComputerName을 지정 New-CimSession 하지 않으면 로컬 컴퓨터에 대한 DCOM 세션을 만듭니다.

New-CimSession

예제 2: 특정 컴퓨터에 대한 CIM 세션 만들기

다음은 ComputerName에서 지정 한 컴퓨터에 대한 CIM 세션을 만드는 예제입니다. 기본적으로 New-CimSession ComputerName을 지정하면 WSMan 세션을 만듭니다.

New-CimSession -ComputerName Server01

예제 3: 여러 컴퓨터에 대한 CIM 세션 만들기

다음은 ComputerName으로 지정된 각 컴퓨터에 대한 CIM 세션을 쉼표로 구분된 목록에 만드는 예제입니다.

New-CimSession -ComputerName Server01,Server02,Server03

예제 4: 친숙한 이름으로 CIM 세션 만들기

다음은 ComputerName으로 지정된 각 컴퓨터에 대한 원격 CIM 세션을 쉼표로 구분된 목록에 만들고 이름을 지정하여 새 세션에 친숙한 이름을 할당하는 예제입니다.

New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*

CIM 세션의 친숙한 이름을 사용하여 다른 CIM cmdlet의 세션을 참조할 수 있습니다(예 : Get-CimSession).

예제 5: PSCredential 개체를 사용하여 컴퓨터에 대한 CIM 세션 만들기

이 예제에서는 자격 증명으로 지정된 PSCredential 개체 및 인증에서 지정한 인증 유형을 사용하여 ComputerName으로 지정된 컴퓨터에 CIM 세션을 만듭니다.

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

cmdlet을 사용하여 PSCredential 개체를 Get-Credential 만들 수 있습니다.

예제 6: 특정 포트를 사용하여 컴퓨터에 대한 CIM 세션 만들기

다음은 포트에서 지정한 TCP 포트를 사용하여 ComputerName에서 지정한 컴퓨터에 대한 CIM 세션을 만드는 예제입니다.

New-CimSession -ComputerName Server01 -Port 1234

예제 7: DCOM을 사용하여 CIM 세션 만들기

이 예제에서는 WSMan 대신 DCOM(Distributed COM) 프로토콜을 사용하여 CIM 세션을 만듭니다.

$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

매개 변수

-Authentication

사용자의 자격 증명에 사용되는 인증 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 기본값
  • 다이제스트
  • Negotiate
  • Basic
  • Kerberos
  • NtlmDomain
  • CredSsp

로컬 컴퓨터에 연결하려면 NtlmDomain 인증 유형을 사용할 수 없습니다. CredSSP 인증은 Windows Vista, Windows Server 2008 이상 버전의 Windows에서만 사용할 수 있습니다.

주의

CredSSP(자격 증명 보안 서비스 공급자) 인증은 원격 네트워크 공유 액세스와 같이 둘 이상의 리소스에 대한 인증이 필요한 명령을 위해 설계되었습니다. 이 메커니즘은 원격 작업의 보안 위험을 높입니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터로 전달된 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.

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

-CertificateThumbprint

이 작업을 수행할 수 있는 권한이 있는 사용자 계정의 디지털 공개 키 인증서(X.509)를 지정합니다. 인증서의 인증서 지문을 입력합니다.

인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 로컬 사용자 계정에만 매핑할 수 있습니다. 도메인 계정에서 작동하지 않습니다.

인증서 지문을 가져오려면 PowerShell 인증서 공급자에서 또는 Get-ChildItem cmdlet을 사용합니다Get-Item.

자세한 내용은 about_Certificate_Provider 참조하세요.

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

-ComputerName

CIM 세션을 만들 컴퓨터의 이름을 지정합니다. 단일 컴퓨터 이름 또는 여러 컴퓨터 이름을 쉼표로 구분하여 지정합니다.

ComputerName을 지정하지 않으면 로컬 컴퓨터에 대한 CIM 세션이 만들어집니다. 다음 형식 중 하나로 컴퓨터 이름 값을 지정할 수 있습니다.

  • 하나 이상의 NetBIOS 이름
  • 하나 이상의 IP 주소
  • 하나 이상의 정규화된 도메인 이름입니다.

컴퓨터가 사용자와 다른 도메인에 있는 경우 정규화된 도메인 이름을 지정해야 합니다.

형식:String[]
별칭:CN, ServerName
Position:1
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Credential

이 작업을 수행할 권한이 있는 사용자 계정을 지정합니다. 자격 증명을 지정하지 않으면 현재 사용자 계정이 사용됩니다.

다음 형식 중 하나를 사용하여 자격 증명 값을 지정합니다.

  • 사용자 이름: "User01"
  • 도메인 이름 및 사용자 이름: "Domain01\User01"
  • 사용자 계정 이름: "User@Domain.com"
  • cmdlet에서 반환 Get-Credential 한 개체와 같은 PSCredential 개체입니다.

사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.

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

-Name

CIM 세션의 이름을 지정합니다.

cmdlet과 같은 다른 cmdlet을 사용할 때 이 이름을 사용하여 CIM 세션을 참조할 Get-CimSession 수 있습니다. 이름은 컴퓨터 또는 현재 세션에 고유할 필요가 없습니다.

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

-OperationTimeoutSec

cmdlet이 서버의 응답을 기다리는 기간입니다.

기본적으로 이 매개 변수의 값은 0입니다. 즉, cmdlet은 서버에 대한 기본 시간 제한 값을 사용합니다.

OperationTimeoutSec 매개 변수가 3분의 강력한 연결 재시도 시간 제한보다 작은 값으로 설정된 경우 클라이언트가 다시 연결하기 전에 서버의 작업이 시간 초과되므로 OperationTimeoutSec 매개 변수 값보다 더 많이 지속되는 네트워크 오류는 복구할 수 없습니다.

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

-Port

이 연결에 사용되는 원격 컴퓨터의 네트워크 포트를 지정합니다. 원격 컴퓨터에 연결하려면 원격 컴퓨터가 연결에서 사용하는 포트에서 수신 대기해야 합니다. 기본 포트는 5985(HTTP용 WinRM 포트) 및 5986(HTTPS용 WinRM 포트)입니다.

대체 포트를 사용하려면 먼저 원격 컴퓨터에 해당 포트에서 수신 대기할 WinRM 수신기를 구성해야 합니다. 다음 명령을 사용하여 수신기를 구성합니다.

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

반드시 사용해야 하는 경우가 아니면 포트 매개 변수를 사용하지 마세요. 명령의 포트 설정은 명령이 실행되는 모든 컴퓨터 또는 세션에 적용됩니다. 대체 포트 설정을 사용하면 명령이 모든 컴퓨터에서 실행되지 않을 수 있습니다.

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

-SessionOption

새 CIM 세션에 대한 고급 옵션을 설정합니다. cmdlet을 사용하여 만든 CimSessionOption 개체의 New-CimSessionOption 이름을 입력합니다.

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

-SkipTestConnection

기본적으로 cmdlet은 New-CimSession 두 가지 이유로 원격 WS 관리 엔드포인트와의 연결을 설정합니다. 즉, 원격 서버가 포트 매개 변수를 사용하여 지정된 포트 번호에서 수신 대기하고 있는지 확인하고 지정된 계정 자격 증명을 확인합니다. 확인은 표준 WS-ID 작업을 사용하여 수행됩니다. 원격 WS-Management 엔드포인트에서 WS-Identify를 사용할 수 없거나 일부 데이터 전송 시간을 줄일 수 없는 경우 SkipTestConnection 스위치 매개 변수를 추가할 수 있습니다.

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

입력

None

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

출력

CimSession

이 cmdlet은 CIM 세션 개체를 반환합니다.