다음을 통해 공유

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은 Windows 플랫폼에서만 사용할 수 있습니다.

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

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

예제

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

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

New-CimSession

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

이 예제에서는 ComputerName지정한 컴퓨터에 대한 CIM 세션을 만듭니다. 기본적으로 New-CimSessionComputerName 지정된 경우 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 세션 만들기

다음은 ComputerName지정한 컴퓨터에 대한 CIM 세션을 만들고, 자격 증명지정된 PSCredential 개체와 인증지정된 인증 유형을 사용합니다.

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

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

예제 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

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

  • 기본값
  • 소화하다
  • 교섭하다
  • 기초의
  • 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-Item 또는 Get-ChildItem cmdlet을 사용합니다.

자세한 내용은 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"
  • Get-Credential cmdlet에서 반환된 개체와 같은 PSCredential 개체입니다.

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

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

-Name

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

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

형식: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 세션에 대한 고급 옵션을 설정합니다. New-CimSessionOption cmdlet을 사용하여 만든 CimSessionOption 개체의 이름을 입력합니다.

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

-SkipTestConnection

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

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

입력

None

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

출력

CimSession

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

참고

PowerShell에는 New-CimSession다음과 같은 별칭이 포함되어 있습니다.

  • Windows:
    • ncms

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