리소스에 대한 New-Item

아티클
11/16/2015

업데이트 날짜: 2014년 10월

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

새 항목을 만듭니다.

구문

New-Item [-ResourceURI <Uri>] [-SupportsOptions] [-ExactMatch] [-Capability <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

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

Resources 디렉터리에서 New-Item cmdlet을 사용하여 플러그 인 리소스를 만들고 구성할 수 있습니다.

매개 변수

-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

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

-SupportsOptions

요청 메시지의 wsman:OptionSet 헤더 내에 전달되는 옵션 사용을 플러그 인에서 지원하는지 여부를 지정합니다.

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

-Exactmatch

Sddl 매개 변수에 지정된 보안 설정을 사용하는 방법을 지정합니다. ExactMatch 매개 변수가 True로 설정된 경우 Sddl의 보안 설정은 URI에 지정된 대로 정확하게 URI 액세스 권한을 부여하기 위해서만 사용됩니다. ExactMatch가 false로 설정된 경우 Sddl의 보안 설정은 URI에 지정된 문자열로 시작하는 URI 액세스 권한을 부여하는 데 사용됩니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	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) 서비스에서 내부적으로 처리됩니다. 따라서 플러그 인에서 작업을 처리할 수 없습니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	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\TestPlugin\Resources -ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema -Capability "Enumerate"

This command creates a resource entry in the Resources directory of TestPlugin.