플러그 인에 대한 New-Item

아티클
11/16/2015

업데이트 날짜: 2014년 10월

적용 대상: Windows PowerShell 4.0, Windows PowerShell 5.0

새 항목을 만듭니다.

구문

New-Item -Plugin <string> -Filename <string> -ResourceURI <Uri> -Capability <string> [-lang <string>] -SDKVersion <string> [-xmlns <string>] -XMLRenderingType <string> [-Confirm] [-WhatIf] [<CommonParameters>]

설명

New-Item cmdlet은 새 항목을 만들고 해당 값을 설정합니다. 생성할 수 있는 항목 종류는 항목의 위치에 따라 다릅니다. 예를 들어 파일 시스템에서는 New-Item을 사용하여 파일과 폴더를 만들 수 있고 레지스트리에서는 New-Item을 사용하여 레지스트리 키와 항목을 만들 수 있습니다.

또한 New-Item은 생성되는 항목의 값을 설정할 수 있습니다. 예를 들어 새 파일을 만들 경우 New-Item을 사용하여 파일에 초기 내용을 추가할 수 있습니다.

매개 변수

-Plugin <string>

플러그 인에 사용할 표시 이름을 지정합니다. 플러그 인이 오류를 반환하는 경우 클라이언트 응용 프로그램에 반환되는 오류 XML에 표시 이름이 추가됩니다. 이 이름은 로캘과 관련이 없습니다.

필수 여부	true
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-FileName <string>

작업 플러그 인의 파일 이름을 지정합니다. 이 항목에 포함된 환경 변수는 요청이 수신될 때 사용자 컨텍스트에서 확장됩니다. 각 사용자가 동일한 환경 변수의 서로 다른 버전을 가질 수 있으므로 다른 플러그 인을 보유할 수 있습니다. 이 항목은 비워 둘 수 없으며 올바른 플러그 인을 가리켜야 합니다.

필수 여부	true
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-ResourceURI <Uri>

디스크 또는 프로세스와 같은 컴퓨터의 특정 리소스 유형을 식별하는 URI(Uniform Resource Identifier)를 지정합니다.

URI는 접두사와 리소스 경로로 구성됩니다. 예를 들면 다음과 같습니다.

https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32\_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM\_NumericSensor

필수 여부	true
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Capability <string>

이 URI(Uniform Resource Identifier)에서 지원되는 작업을 지정합니다. URI가 지원하는 각 작업 유형에 대해 하나의 항목을 만들어야 합니다. 다음은 유효한 값입니다.

-- Create: URI에서 Create 작업이 지원됩니다. SupportFragment 특성은 Create 작업이 해당 개념을 지원하는 경우에 사용됩니다. SupportFiltering 특성은 유효하지 않으므로 False로 설정해야 합니다. Shell 작업도 지원되는 경우 이 작업은 URI에 대해 유효하지 않습니다.

-- Delete: URI에서 Delete 작업이 지원됩니다. SupportFragment 특성은 Delete 작업이 해당 개념을 지원하는 경우에 사용됩니다. SupportFiltering 특성은 유효하지 않으므로 False로 설정해야 합니다. Shell 작업도 지원되는 경우 이 작업은 URI에 대해 유효하지 않습니다.

-- Enumerate: URI에서 Enumerate 작업이 지원됩니다. SupportFragment 특성은 Enumerate 작업에 지원되지 않으므로 False로 설정해야 합니다. SupportFiltering 특성이 유효하고 플러그 인이 필터링을 지원하는 경우 이 특성을 True로 설정해야 합니다. Shell 작업도 지원되는 경우 이 작업은 URI에 대해 유효하지 않습니다.

-- Get: URI에서 Get 작업이 지원됩니다. SupportFragment 특성은 Get 작업이 해당 개념을 지원하는 경우에 사용됩니다. SupportFiltering 특성은 유효하지 않으므로 False로 설정해야 합니다. Shell 작업도 지원되는 경우 이 작업은 URI에 대해 유효하지 않습니다.

-- Invoke: URI에서 Invoke 작업이 지원됩니다. SupportFragment 특성은 Invoke 작업에 지원되지 않으므로 False로 설정해야 합니다. SupportFiltering 특성은 유효하지 않으므로 False로 설정해야 합니다. Shell 작업도 지원되는 경우 이 작업은 URI에 대해 유효하지 않습니다.

-- Put: URI에서 Put 작업이 지원됩니다. SupportFragment 특성은 Put 작업이 해당 개념을 지원하는 경우에 사용됩니다. SupportFiltering 특성은 유효하지 않으므로 False로 설정해야 합니다. Shell 작업도 지원되는 경우 이 작업은 URI에 대해 유효하지 않습니다.

-- Subscribe: URI에서 Subscribe 작업이 지원됩니다. SupportFragment 특성은 Subscribe 작업에 지원되지 않으므로 False로 설정해야 합니다. SupportFiltering 특성은 유효하지 않으므로 False로 설정해야 합니다. Shell 작업도 지원되는 경우 이 작업은 URI에 대해 유효하지 않습니다.

-- Shell: URI에서 Shell 작업이 지원됩니다. SupportFragment 특성은 Shell 작업에 지원되지 않으므로 False로 설정해야 합니다. SupportFiltering 특성은 유효하지 않으므로 False로 설정해야 합니다. 다른 작업이 하나라도 지원되는 경우 이 작업은 URI에 대해 유효하지 않습니다. URI에 대해 Shell 작업이 구성된 경우 Get, Put, Create, Delete, Invoke 및 Enumerate 작업은 셸을 관리하기 위해 WS-Management(WinRM) 서비스에서 내부적으로 처리됩니다. 따라서 플러그 인에서 작업을 처리할 수 없습니다.

필수 여부	true
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-lang <string>

언어 및 지역이 하이픈으로 구분된 언어-지역이나 언어를 지정하는 문자열입니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-SDKVersion <string>

WS-Management 플러그 인 SDK의 버전을 지정합니다. 유효한 값은 1뿐입니다.

필수 여부	true
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-xmlns <string>

네임스페이스를 고유하게 식별하는 URN(Uniform Resource Name)을 지정하는 문자열입니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-XMLRenderingType <string>

WSMAN_DATA 개체를 통해 XML이 플러그 인에 전달되는 형식을 지정합니다. 다음은 유효한 값입니다.

텍스트: 들어오는 XML 데이터가 XML을 PCWSTR 메모리 버퍼로 나타내는 WSMAN_DATA_TYPE_TEXT 구조에 포함됩니다.

XMLReader: 들어오는 XML 데이터가 XML을 WebServices.h 헤더 파일에 정의된 XmlReader 개체로 나타내는 WSMAN_DATA_TYPE_WS_XML_READER 구조에 포함됩니다.

필수 여부	true
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Confirm

명령을 실행하기 전에 확인을 요청하는 메시지가 표시됩니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-WhatIf

명령을 실제로 실행하지 않으면서 명령을 실행할 경우 어떻게 되는지 설명해 보세요.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력 및 출력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Object

새 항목의 값을 New-Item cmdlet으로 파이프할 수 있습니다.

출력

임의

참고

New-Item cmdlet은 모든 공급자가 공개하는 데이터에 사용할 수 있습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 "Get-PsProvider"를 입력합니다. 자세한 내용은 About_Providers를 참조하세요.

예제 1

C:\PS>New-Item -Path WSMan:\localhost\Plugin -Force -Name "Test Plugin" -File C:\Testplugin.xml
              
              Where Testplugin.xml contains:
              

This command creates (registers) a plug-in for the WS-Management service. This example uses an XML file to load all of the necessary setting to create a plug-in.








This command creates (registers) a plug-in for the WS-Management service. This example uses an XML file to load all of the necessary setting to create a plug-in.

예제 2

C:\PS>New-Item -Path WSMan:\localhost\Plugin -Plugin TestPlugin -FileName %systemroot%\system32\WsmWmiPl.dll -Resource http://schemas.dmtf.org/wbem/wscim/2/cim-schema -SDKVersion 1 -Capability "Get","Put","Invoke","Enumerate" -XMLRenderingType text

This command creates (registers) a plug-in for the WS-Management service.