New-Item

모듈:

Microsoft.PowerShell.Management

새 항목을 만듭니다.

구문

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

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

New-Item
   [-Path] <string[]>
   -ConnectionURI <uri>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-Port <int>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-ApplicationName <string>]
   [-Port <int>]
   [-UseSSL]
   [<CommonParameters>]

New-Item
   [-Path] <string[]>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

Description

cmdlet은 New-Item 새 항목을 만들고 해당 값을 설정합니다. 만들 수 있는 항목의 형식은 항목의 위치에 따라 달라집니다. 예를 들어 파일 시스템에서 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: 디렉터리 만들기

이 명령은 드라이브에 "Logfiles" C: 라는 디렉터리를 만듭니다. 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

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

예제 6: 와일드카드를 사용하여 여러 디렉터리에 파일 만들기

cmdlet은 New-Item Path 매개 변수에서 와일드카드를 지원합니다. 다음 명령은 Pathtemp.txt로 지정된 모든 디렉터리에 파일을 만듭니다.

Get-ChildItem -Path C:\Temp\

Directory:  C:\Temp

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d-----        5/15/2019   6:45 AM        1   One
d-----        5/15/2019   6:45 AM        1   Two
d-----        5/15/2019   6:45 AM        1   Three

New-Item -Path C:\Temp\* -Name temp.txt -ItemType File | Select-Object FullName

FullName
--------
C:\Temp\One\temp.txt
C:\Temp\Three\temp.txt
C:\Temp\Two\temp.txt

cmdlet은 Get-ChildItem 디렉터리 아래에 C:\Temp 세 개의 디렉터리를 표시합니다. 와일드카드를 사용하여 cmdlet은 New-Item 현재 디렉터리 아래의 모든 디렉터리에 파일을 만듭니다 temp.txt . cmdlet은 New-Item 새로 만든 파일의 경로를 확인하기 위해 Select-Object 파이프되는 사용자가 만든 항목을 출력합니다.

예제 7: 파일 또는 폴더에 대한 기호 링크 만들기

다음은 현재 폴더의 Notice.txt 파일에 대한 기호 링크를 만드는 예제입니다.

$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt
$link | Select-Object LinkType, Target

LinkType     Target
--------     ------
SymbolicLink {.\Notice.txt}

이 예제에서 Target은 Value 매개 변수의 별칭입니다. 기호 링크의 대상은 상대 경로일 수 있습니다. PowerShell v6.2 이전에는 대상이 정규화된 경로여야 합니다.

PowerShell 7.1부터 이제 상대 경로를 사용하여 Windows의 폴더에 대한 SymbolicLink를 만들 수 있습니다.

예제 8: -Force 매개 변수를 사용하여 폴더 다시 생성 시도

이 예제에서는 내부에 파일이 있는 폴더를 만듭니다. 그런 다음 , 를 사용하여 -Force동일한 폴더를 만들려고 시도합니다. 폴더를 덮어쓰지 않고 파일을 그대로 만든 기존 폴더 개체를 반환하기만 하면 됩니다.

PS> New-Item -Path .\TestFolder -ItemType Directory
PS> New-Item -Path .\TestFolder\TestFile.txt -ItemType File

PS> New-Item -Path .\TestFolder -ItemType Directory -Force

    Directory: C:\
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         5/1/2020   8:03 AM                TestFolder

PS> Get-ChildItem .\TestFolder\

    Directory: C:\TestFolder
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:03 AM              0 TestFile.txt

예제 9: Force 매개 변수를 사용하여 기존 파일 덮어쓰기

이 예제에서는 값이 있는 파일을 만든 다음 Force 매개 변수를 사용하여 파일을 다시 만듭니다. Length 속성에서 볼 수 있듯이 기존 파일을 덮어씁니다.

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file'

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM             24 TestFile.txt

New-Item ./TestFile.txt -ItemType File -Force

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM              0 TestFile.txt

참고 항목

New-Item 매개 변수와 함께 사용하여 레지스트리 키를 만드는 경우 명령은 파일을 덮어쓸 때와 동일하게 동작합니다. 레지스트리 키가 이미 있는 경우 키와 모든 속성 및 값을 빈 레지스트리 키로 덮어씁니다.

매개 변수

-ApplicationName

WSMan 공급자가 사용할 수 있는 동적 매개 변수입니다. WSMan 공급자 및 이 매개 변수는 Windows에서만 사용할 수 있습니다.

연결의 애플리케이션 이름을 지정합니다. ApplicationName 매개 변수의 기본값은 WSMAN입니다.

자세한 내용은 New-WSManInstance를 참조 하세요.

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

-Authentication

WSMan 공급자가 사용할 수 있는 동적 매개 변수입니다. WSMan 공급자 및 이 매개 변수는 Windows에서만 사용할 수 있습니다.

서버에서 사용할 인증 메커니즘을 지정합니다.

자세한 내용은 New-WSManInstance를 참조 하세요.

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

-CertificateThumbprint

WSMan 공급자가 사용할 수 있는 동적 매개 변수입니다. WSMan 공급자 및 이 매개 변수는 Windows에서만 사용할 수 있습니다.

이 WSMan 작업을 수행할 수 있는 권한이 있는 사용자 계정의 디지털 공개 키 인증서(X509)를 지정합니다. 인증서의 인증서 지문을 입력합니다.

자세한 내용은 New-WSManInstance를 참조 하세요.

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

-Confirm

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

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

-ConnectionURI

WSMan 공급자가 사용할 수 있는 동적 매개 변수입니다. WSMan 공급자 및 이 매개 변수는 Windows에서만 사용할 수 있습니다.

WSMan에 대한 연결 엔드포인트를 지정합니다.

자세한 내용은 New-WSManInstance를 참조 하세요.

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

-Credential

참고 항목

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

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

-Force

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

PowerShell 7.4부터 이 매개 변수를 사용하면 기존 정션을 덮어쓸 수도 있습니다. 이전에는 "비어 있지 않으므로 제거할 수 없습니다." 오류로 인해 실패했습니다.

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

-ItemType

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

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

• File
• Directory
• SymbolicLink
• Junction
• HardLink

참고 항목

Windows에서 형식을 SymbolicLink 만들려면 관리자 권한 상승이 필요합니다. 그러나 개발자 모드를 사용하도록 설정된 Windows 10(빌드 14972 이상)에는 더 이상 기호 링크를 만드는 권한 상승이 필요하지 않습니다.

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

• Certificate Provider
• Certificate
• Store
• 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

-Options

별칭 공급자가 사용할 수 있는 동적 매개 변수입니다 . 자세한 내용은 New-Alias를 참조 하세요.

별칭의 Options 속성 값을 지정합니다.

유효한 값은 다음과 같습니다.

• None: 별칭에 제약 조건이 없습니다(기본값).
• ReadOnly: 별칭은 삭제할 수 있지만 Force 매개 변수를 사용하지 않고는 변경할 수 없습니다.
• Constant: 별칭을 삭제하거나 변경할 수 없습니다.
• Private: 별칭은 현재 범위에서만 사용할 수 있습니다.
• AllScope: 별칭이 생성된 새 범위에 복사됩니다.
• Unspecified: 옵션이 지정되지 않았습니다.

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

-OptionSet

WSMan 공급자가 사용할 수 있는 동적 매개 변수입니다. WSMan 공급자 및 이 매개 변수는 Windows에서만 사용할 수 있습니다.

요청의 특성을 수정하거나 구체화하기 위해 스위치 집합을 서비스에 전달합니다.

자세한 내용은 New-WSManInstance를 참조 하세요.

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

-Path

새 항목의 위치 경로를 지정합니다. 기본값은 경로를 생략할 때 현재 위치입니다. 이름에 새 항목의 이름을 지정하거나 경로에 포함할 수 있습니다. Name 매개 변수를 사용하여 전달된 항목 이름은 Path 매개 변수의 값을 기준으로 만들어집니다.

이 cmdlet의 경우 Path 매개 변수는 다른 cmdlet의 LiteralPath 매개 변수처럼 작동합니다. 와일드카드 문자는 해석되지 않습니다. 모든 문자는 위치의 공급자에게 전달됩니다. 공급자가 모든 문자를 지원하지 않을 수 있습니다. 예를 들어 별표(*) 문자가 포함된 파일 이름은 만들 수 없습니다.

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

-Port

WSMan 공급자가 사용할 수 있는 동적 매개 변수입니다. WSMan 공급자 및 이 매개 변수는 Windows에서만 사용할 수 있습니다.

클라이언트가 WinRM 서비스에 연결할 때 사용할 포트를 지정합니다.

자세한 내용은 New-WSManInstance를 참조 하세요.

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

-SessionOption

WSMan 공급자가 사용할 수 있는 동적 매개 변수입니다. WSMan 공급자 및 이 매개 변수는 Windows에서만 사용할 수 있습니다.

WS-Management 세션에 대한 확장된 옵션 집합을 정의합니다.

자세한 내용은 New-WSManInstance를 참조 하세요.

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

-UseSSL

WSMan 공급자가 사용할 수 있는 동적 매개 변수입니다. WSMan 공급자 및 이 매개 변수는 Windows에서만 사용할 수 있습니다.

SSL(Secure Sockets Layer) 프로토콜을 사용하여 원격 컴퓨터에 대한 연결을 설정하도록 지정합니다. 기본적으로 SSL은 사용되지 않습니다.

자세한 내용은 New-WSManInstance를 참조 하세요.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	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으로 파이프할 수 있습니다.

출력

DictionaryEntry

cmdlet은 새 환경 변수를 만들 때 DictionaryEntry 개체를 반환합니다.

DirectoryInfo

이 cmdlet은 파일 시스템에 새 디렉터리를 만들 때 DirectoryInfo 개체를 반환합니다.

FileInfo

이 cmdlet은 파일 시스템에 새 파일을 만들 때 FileInfo 개체를 반환합니다.

AliasInfo

cmdlet은 새 별칭을 만들 때 AliasInfo 개체를 반환합니다.

FunctionInfo

cmdlet은 새 함수를 만들 때 FunctionInfo 개체를 반환합니다.

PSVariable

cmdlet은 새 변수를 만들 때 PSVariable 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.New-Item

• 모든 플랫폼:
  • ni

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

관련 링크

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• 항목 이동
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers