New-CimSessionOption

참조

모듈:: CimCmdlets

New-CimSession cmdlet에 대한 고급 옵션을 지정합니다.

구문

New-CimSessionOption
   [-Protocol] <ProtocolType>
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

New-CimSessionOption
   [-NoEncryption]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-EncodePortInServicePrincipalName]
   [-Encoding <PacketEncoding>]
   [-HttpPrefix <Uri>]
   [-MaxEnvelopeSizeKB <UInt32>]
   [-ProxyAuthentication <PasswordAuthenticationMechanism>]
   [-ProxyCertificateThumbprint <String>]
   [-ProxyCredential <PSCredential>]
   [-ProxyType <ProxyType>]
   [-UseSsl]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

New-CimSessionOption
   [-Impersonation <ImpersonationType>]
   [-PacketIntegrity]
   [-PacketPrivacy]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

Description

New-CimSessionOption cmdlet은 CIM 세션 옵션 개체의 인스턴스를 만듭니다. CIM 세션 옵션 개체를 New-CimSession cmdlet에 대한 입력으로 사용하여 CIM 세션에 대한 옵션을 지정합니다.

이 cmdlet에는 WsMan 옵션과 DCOM(분산 구성 요소 개체 모델) 옵션에 대한 매개 변수 집합이 있습니다. 사용하는 매개 변수에 따라 cmdlet은 DCOM 세션 옵션의 인스턴스를 반환하거나 WsMan 세션 옵션을 반환합니다.

예제

예제 1: DCOM에 대한 CIM 세션 옵션 개체 만들기

이 예제에서는 DCOM 프로토콜에 대한 CIM 세션 옵션 개체를 만들고 $so변수에 저장합니다. 그런 다음 변수의 내용이 New-CimSession cmdlet에 전달됩니다. 그런 다음 New-CimSession 변수에 정의된 옵션을 사용하여 Server01이라는 원격 서버로 새 CIM 세션을 만듭니다.

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

예제 2: WsMan에 대한 CIM 세션 옵션 개체 만들기

이 예제에서는 WsMan 프로토콜에 대한 CIM 세션 옵션 개체를 만듭니다. 개체에는 ProxyAuthentication 매개 변수로 지정된 Kerberos 인증 모드에 대한 구성, ProxyCredential 매개 변수로 지정된 자격 증명 및 명령이 CA 검사를 건너뛰고 CN 검사를 건너뛰고 SSL을 사용하도록 지정합니다.

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

예제 3: 문화권이 지정된 CIM 세션 옵션 개체 만들기

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

이 예제에서는 CIM 세션에 사용되는 문화권을 지정합니다. 기본적으로 클라이언트의 문화권은 작업을 수행할 때 사용됩니다. 그러나 Culture 매개 변수를 사용하여 기본 문화권을 재정의할 수 있습니다.

매개 변수

-Culture

CIM 세션에 사용할 사용자 인터페이스 문화권을 지정합니다. 다음 형식 중 하나를 사용하여 이 매개 변수의 값을 지정합니다.

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

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

-EncodePortInServicePrincipalName

Kerberos 연결이 SPN(서비스 사용자 이름)에 서비스 포트 번호가 포함된 서비스에 연결 중임을 나타냅니다. 이 유형의 연결은 일반적이지 않습니다.

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

-Encoding

WsMan 프로토콜에 사용되는 인코딩을 지정합니다. 이 매개 변수에 허용되는 값은 Default, Utf8또는 Utf16.

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

-HttpPrefix

컴퓨터 이름 및 포트 번호 뒤의 HTTP URL 부분을 지정합니다. 이를 변경하는 것은 일반적이지 않습니다. 기본적으로 이 매개 변수의 값은 /wsman .

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

-Impersonation

가장을 사용하여 WMI(Windows Management Instrumentation)에 대한 DCOM 세션을 만듭니다.

이 매개 변수의 유효한 값은 다음과 같습니다.

기본값: DCOM은 일반적인 보안 협상 알고리즘을 사용하여 가장 수준을 선택할 수 있습니다.
없음: 클라이언트는 서버에 익명입니다. 서버 프로세스는 클라이언트를 가장할 수 있지만 가장 토큰은 정보를 포함하지 않으며 사용할 수 없습니다.
식별: 개체가 호출자의 자격 증명을 쿼리할 수 있도록 허용합니다.
가장: 개체가 호출자의 자격 증명을 사용할 수 있도록 허용합니다.
대리자: 개체가 다른 개체가 호출자의 자격 증명을 사용하도록 허용할 수 있습니다.

가장 지정되지 않은 경우 New-CimSession cmdlet은 Impersonate값을 사용합니다.

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

-MaxEnvelopeSizeKB

어느 방향으로든 WsMan XML 메시지의 크기 제한을 지정합니다.

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

-NoEncryption

데이터 암호화가 해제되도록 지정합니다.

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

-PacketIntegrity

WMI에 만든 DCOM 세션에서 PACKETIntegrity 기능을 COM(구성 요소 개체 모델)을 사용하도록 지정합니다. 기본적으로 DCOM을 사용하여 만든 모든 CIM 세션에는 PacketIntegrity 매개 변수가 true 설정됩니다.

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

-PacketPrivacy

COM PacketPrivacy사용하여 WMI에 대한 DCOM 세션을 만듭니다. 기본적으로 DCOM을 사용하여 만든 모든 CIM 세션에는 PacketPrivacy 매개 변수가 true 설정됩니다.

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

-Protocol

사용할 프로토콜을 지정합니다. 이 매개 변수에 허용되는 값은 DCOM, 기본또는 Wsman .

형식:	ProtocolType
허용되는 값:	Dcom, Default, Wsman
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ProxyAuthentication

프록시 확인에 사용할 인증 방법을 지정합니다. 이 매개 변수에 허용되는 값은 Default, Digest, negotiate, Basic, Kerberos, NtlmDomain또는 CredSsp.

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

-ProxyCertificateThumbprint

프록시 인증을 위해 사용자 계정의 (x.509) 디지털 공개 키 인증서를 지정합니다. 인증서의 인증서 지문을 입력합니다. 인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 로컬 사용자 계정에만 매핑할 수 있으며 도메인 계정에서 작동하지 않습니다.

인증서 지문을 가져오려면 PowerShell 인증서: 드라이브에서 Get-Item 또는 Get-ChildItem cmdlet을 사용합니다.

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

-ProxyCredential

프록시 인증에 사용할 자격 증명을 지정합니다. 다음 중 하나를 입력합니다.

PSCredential 개체를 포함하는 변수입니다.
PSCredential 개체를 가져오는 명령(예: Get-Credential

이 옵션을 설정하지 않으면 자격 증명을 지정할 수 없습니다.

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

-ProxyType

사용할 호스트 이름 확인 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 None, WinHttp, Auto또는 internetExplorer .

이 매개 변수의 기본값은 InternetExplorer .

형식:	ProxyType
허용되는 값:	None, WinHttp, Auto, InternetExplorer
Position:	Named
Default value:	InternetExplorer
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-SkipCACheck

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

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

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

-SkipCNCheck

서버의 인증서 CN(일반 이름)이 서버의 호스트 이름과 일치하지 않아도 됨을 나타냅니다. HTTPS 프로토콜을 사용하는 신뢰할 수 있는 컴퓨터에서만 원격 작업에 이 매개 변수를 사용합니다.

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

-SkipRevocationCheck

서버 인증서에 대한 해지 검사를 건너뛰고 있음을 나타냅니다. 신뢰할 수 있는 컴퓨터에 대해서만 이 매개 변수를 사용합니다.

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

-UICulture

CIM 세션에 사용할 사용자 인터페이스 문화권을 지정합니다. 다음 형식 중 하나를 사용하여 이 매개 변수의 값을 지정합니다.

"EN-US"와 같은 <languagecode2>-<country/regioncode2> 형식의 문화권 이름입니다.
CultureInfo 개체를 포함하는 변수입니다.
cultureInfo 개체(예: Get-Culture)를 가져오는 명령입니다.

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

-UseSsl

원격 컴퓨터에 대한 연결을 설정하는 데 SSL을 사용해야 임을 나타냅니다. 기본적으로 SSL은 사용되지 않습니다. WsMan은 HTTP를 사용하는 경우에도 네트워크를 통해 전송되는 모든 콘텐츠를 암호화합니다.

이 매개 변수를 사용하면 HTTP 대신 HTTPS의 추가 보호를 지정할 수 있습니다. 연결에 사용되는 포트에서 SSL을 사용할 수 없으며 이 매개 변수를 지정하면 명령이 실패합니다.

PacketPrivacy 매개 변수가 지정되지 않은 경우에만 이 매개 변수를 사용하는 것이 좋습니다.

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

입력

None

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

출력

CimSessionOptions

이 cmdlet은 CIM 세션 옵션 정보를 포함하는 개체를 반환합니다.

다음을 통해 공유

New-CimSessionOption

구문

Description

예제

예제 1: DCOM에 대한 CIM 세션 옵션 개체 만들기

예제 2: WsMan에 대한 CIM 세션 옵션 개체 만들기

예제 3: 문화권이 지정된 CIM 세션 옵션 개체 만들기

매개 변수

-Culture

-EncodePortInServicePrincipalName

-Encoding

-HttpPrefix

-Impersonation

-MaxEnvelopeSizeKB

-NoEncryption

-PacketIntegrity

-PacketPrivacy

-Protocol

-ProxyAuthentication

-ProxyCertificateThumbprint

-ProxyCredential

-ProxyType

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseSsl

입력

출력

추가 리소스

다음을 통해 공유

New-CimSessionOption

구문

Description

예제

예제 1: DCOM에 대한 CIM 세션 옵션 개체 만들기

예제 2: WsMan에 대한 CIM 세션 옵션 개체 만들기

예제 3: 문화권이 지정된 CIM 세션 옵션 개체 만들기

매개 변수

-Culture

-EncodePortInServicePrincipalName

-Encoding

-HttpPrefix

-Impersonation

-MaxEnvelopeSizeKB

-NoEncryption

-PacketIntegrity

-PacketPrivacy

-Protocol

-ProxyAuthentication

-ProxyCertificateThumbprint

-ProxyCredential

-ProxyType

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseSsl

입력

출력

관련 링크

추가 리소스