New-Item

Синтаксис

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>]

Описание

Командлет 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. Создание профиля

Эта команда создает профиль PowerShell в пути, указанном переменной $profile .

Профили можно использовать для настройки PowerShell. $profile — это автоматическая (встроенная) переменная, в которой хранятся путь и имя файла профиля CurrentUser/CurrentHost. По умолчанию профиль не существует, даже если PowerShell хранит путь и имя файла для него.

В этой команде $profile переменная представляет путь к файлу. Параметр ItemType указывает, что команда создает файл. Параметр Force позволяет создать файл в пути профиля, даже если каталоги в пути не существуют.

После создания профиля можно ввести псевдонимы, функции и скрипты в профиле, чтобы настроить оболочку.

Дополнительные сведения см. в about_Automatic_Variables и about_Profiles.

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

Пример 4. Создание каталога в другом каталоге

В этом примере создается новый каталог скриптов в каталоге C:\PS-Test.

Имя нового элемента каталога "Скрипты" включается в значение параметра Path , а не указано в значении Name. Как указывается в синтаксисе, любая форма команды допустима.

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. Использование подстановочных знаков для создания файлов в нескольких каталогах

Командлет New-Item поддерживает подстановочные знаки в параметре Path . Следующая команда создает temp.txt файл во всех каталогах, указанных подстановочными знаками в параметре Path .

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

Командлет Get-ChildItem показывает три каталога в каталоге C:\Temp . С помощью подстановочных New-Item знаков командлет создает temp.txt файл во всех каталогах в текущем каталоге. Командлет 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 версии 6.2 целевой объект должен быть полным путем.

Начиная с PowerShell 7.1, теперь вы можете создать символьную ссылку на папку в Windows с помощью относительного пути.

Пример 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

Параметры

-ApplicationName

-Authentication

-CertificateThumbprint

-Confirm

-ConnectionURI

-Credential

-Force

-ItemType

-Name

-Options

-OptionSet

-Path

-Port

-SessionOption

-UseSSL

-Value

-WhatIf

Входные данные

Object

Можно передать значение нового элемента в этот командлет.

Выходные данные

DictionaryEntry

Командлет возвращает объект DictionaryEntry при создании новой переменной среды.

DirectoryInfo

Командлет возвращает объект DirectoryInfo при создании нового каталога в файловой системе.

FileInfo

Командлет возвращает объект FileInfo при создании нового файла в файловой системе.

AliasInfo

Командлет возвращает объект AliasInfo при создании нового псевдонима.

FunctionInfo

Командлет возвращает объект FunctionInfo при создании новой функции.

PSVariable

Командлет возвращает объект PSVariable при создании новой переменной.

Примечания

PowerShell включает следующие псевдонимы для New-Item:

• Все платформы:
  • ni

New-Item предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в данном сеансе, введите командлет Get-PsProvider. Дополнительные сведения см. в about_Providers.

Связанные ссылки

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• Move-Item
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers