다음을 통해 공유

New-Item

  • 참조
모듈:
Microsoft.PowerShell.Management

새 항목을 만듭니다.

구문

New-Item
   [-Path] <String[]>
   [-ItemType <String>]
   [-Value <Object>]
   [-Force]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]
New-Item
   [[-Path] <String[]>]
   -Name <String>
   [-ItemType <String>]
   [-Value <Object>]
   [-Force]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

Description

New-Item cmdlet은 새 항목을 만들고 해당 값을 설정합니다. 만들 수 있는 항목의 형식은 항목의 위치에 따라 달라집니다. 예를 들어 파일 시스템에서 New-Item 파일 및 폴더를 만듭니다. 레지스트리에서 New-Item 레지스트리 키와 항목을 만듭니다.

New-Item 만드는 항목의 값을 설정할 수도 있습니다. 예를 들어 새 파일을 만들 때 New-Item 파일에 초기 콘텐츠를 추가할 수 있습니다.

예제

예제 1: 현재 디렉터리에 파일 만들기

이 명령은 현재 디렉터리에 "testfile1.txt"이라는 텍스트 파일을 만듭니다. Path 매개 변수 값의 점('.')은 현재 디렉터리를 나타냅니다. Value 매개 변수 뒤에 있는 따옴표 붙은 텍스트가 파일에 콘텐츠로 추가됩니다.

New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."

예제 2: 디렉터리 만들기

이 명령은 C: 드라이브에 "Logfiles"라는 디렉터리를 만듭니다. ItemType 매개 변수는 새 항목이 파일 또는 다른 파일 시스템 개체가 아닌 디렉터리임을 지정합니다.

New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"

예제 3: 프로필 만들기

이 명령은 $profile 변수로 지정된 경로에 PowerShell 프로필을 만듭니다.

프로필을 사용하여 PowerShell을 사용자 지정할 수 있습니다. $profile "CurrentUser/CurrentHost" 프로필의 경로 및 파일 이름을 저장하는 자동(기본 제공) 변수입니다. PowerShell에서 경로와 파일 이름을 저장하더라도 기본적으로 프로필은 존재하지 않습니다.

이 명령에서 $profile 변수는 파일의 경로를 나타냅니다. ItemType 매개 변수는 명령이 파일을 만들게 지정합니다. Force 매개 변수를 사용하면 경로의 디렉터리에 없는 경우에도 프로필 경로에 파일을 만들 수 있습니다.

프로필을 만든 후 프로필에 별칭, 함수 및 스크립트를 입력하여 셸을 사용자 지정할 수 있습니다.

자세한 내용은 about_Automatic_Variables 및 about_Profiles참조하세요.

New-Item -Path $profile -ItemType "file" -Force

메모

이 메서드를 사용하여 파일을 만들 때 결과 파일은 BOM(바이트 순서 표시) 없이 UTF-8로 인코딩됩니다.

예제 4: 다른 디렉터리에 디렉터리 만들기

이 예제에서는 "C:\PS-Test" 디렉터리에 새 스크립트 디렉터리를 만듭니다.

새 디렉터리 항목의 이름인 "Scripts"는 Name값에 지정되지 않고 Path 매개 변수 값에 포함됩니다. 구문에 표시된 대로 두 명령 형식이 모두 유효합니다.

New-Item -ItemType "directory" -Path "c:\ps-test\scripts"

예제 5: 여러 파일 만들기

이 예제에서는 두 개의 서로 다른 디렉터리에 파일을 만듭니다. 경로 여러 문자열을 사용하므로 이를 사용하여 여러 항목을 만들 수 있습니다.

New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-Credential

메모

이 매개 변수는 PowerShell과 함께 설치된 공급자에서 지원되지 않습니다. 이 cmdlet을 실행할 때 다른 사용자를 가장하거나 자격 증명을 높이려면 Invoke-Command사용합니다.

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

-Force

이 cmdlet이 기존 읽기 전용 항목에 대해 쓰는 항목을 만들도록 합니다. 구현은 공급자마다 다릅니다. 자세한 내용은 about_Providers참조하세요. Force 매개 변수를 사용하더라도 cmdlet은 보안 제한을 재정의할 수 없습니다.

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

-ItemType

새 항목의 공급자 지정 형식을 지정합니다. 이 매개 변수의 사용 가능한 값은 사용 중인 현재 공급자에 따라 달라집니다.

위치가 FileSystem 드라이브에 있는 경우 다음 값이 허용됩니다.

  • 파일
  • 디렉토리
  • SymbolicLink
  • 접합
  • HardLink

이 메서드를 사용하여 파일을 만들 때 결과 파일은 BOM(바이트 순서 표시) 없이 UTF-8로 인코딩됩니다.

Certificate 드라이브에서 지정할 수 있는 값은 다음과 같습니다.

  • 인증서 공급자
  • 증명서
  • 가게
  • StoreLocation

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

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

-Name

새 항목의 이름을 지정합니다.

Name 또는 Path 매개 변수 값에서 새 항목의 이름을 지정할 수 있으며 Name 또는 Path 값에서 새 항목의 경로를 지정할 수 있습니다.

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

-Path

새 항목의 위치 경로를 지정합니다. 와일드카드 문자가 허용됩니다.

이름새 항목의 이름을 지정하거나 경로포함할 수 있습니다.

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

-UseTransaction

활성 트랜잭션에 명령을 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_Transactions참조하세요.

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

-Value

새 항목의 값을 지정합니다. 값을 New-Item파이프할 수도 있습니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

입력

Object

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

출력

Object

이 cmdlet은 만든 항목을 반환합니다.

참고

New-Item 공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 Get-PsProvider입력합니다. 자세한 내용은 about_Providers참조하세요.