New-Item

Modül:

Microsoft.PowerShell.Management

Yeni bir öğe oluşturur.

Syntax

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

New-Item cmdlet'i yeni bir öğe oluşturur ve değerini ayarlar. Oluşturulabilecek öğe türleri, öğenin konumuna bağlıdır. Örneğin, dosya sisteminde New-Item dosya ve klasörler oluşturur. Kayıt defterinde kayıt New-Item defteri anahtarlarını ve girdilerini oluşturur.

New-Item , oluşturduğu öğelerin değerini de ayarlayabilir. Örneğin, yeni bir dosya oluşturduğunda, New-Item dosyaya ilk içeriği ekleyebilir.

Örnekler

Örnek 1: Geçerli dizinde dosya oluşturma

Bu komut geçerli dizinde "testfile1.txt" adlı bir metin dosyası oluşturur. Path parametresinin değerindeki nokta ('.'), geçerli dizini gösterir. Value parametresini izleyen tırnak içine alınmış metin dosyaya içerik olarak eklenir.

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

Örnek 2: Dizin oluşturma

Bu komut, sürücüde C: "Logfiles" adlı bir dizin oluşturur. ItemType parametresi, yeni öğenin bir dosya veya başka bir dosya sistemi nesnesi değil bir dizin olduğunu belirtir.

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

Örnek 3: Profil oluşturma

Bu komut, değişkeni tarafından $profile belirtilen yolda bir PowerShell profili oluşturur.

PowerShell'i özelleştirmek için profilleri kullanabilirsiniz. $profile , "CurrentUser/CurrentHost" profilinin yolunu ve dosya adını depolayan otomatik (yerleşik) bir değişkendir. Varsayılan olarak, PowerShell bunun için bir yol ve dosya adı depolasa bile profil mevcut değildir.

Bu komutta $profile değişkeni dosyanın yolunu temsil eder. ItemType parametresi komutun bir dosya oluşturduğunu belirtir. Force parametresi, yoldaki dizinler mevcut olmasa bile profil yolunda bir dosya oluşturmanıza olanak tanır.

Profil oluşturduktan sonra, kabuğunuzu özelleştirmek için profile diğer adlar, işlevler ve betikler girebilirsiniz.

Daha fazla bilgi için bkz. about_Automatic_Variables ve about_Profiles.

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

Örnek 4: Farklı bir dizinde dizin oluşturma

Bu örnek, "C:\PS-Test" dizininde yeni bir Betikler dizini oluşturur.

Yeni dizin öğesinin adı olan "Betikler", Ad değerinde belirtilme yerine Path parametresinin değerine eklenir. Söz diziminde belirtildiği gibi, her iki komut formu da geçerlidir.

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

Örnek 5: Birden çok dosya oluşturma

Bu örnek, iki farklı dizinde dosya oluşturur. Path birden çok dize aldığından, birden çok öğe oluşturmak için bunu kullanabilirsiniz.

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

Örnek 6: Birden çok dizinde dosya oluşturmak için joker karakter kullanma

Cmdlet, New-ItemPath parametresindeki joker karakterleri destekler. Aşağıdaki komut, Path parametresindeki joker karakterler tarafından belirtilen tüm dizinlerde bir temp.txt dosya oluşturur.

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'i Get-ChildItem dizinin altında C:\Temp üç dizin gösterir. Cmdlet, joker karakterler New-Item kullanarak geçerli dizinin altındaki tüm dizinlerde bir temp.txt dosya oluşturur. cmdlet'i New-Item , yeni oluşturulan dosyaların yollarını doğrulamak için Select-Object yöneltilen, oluşturduğunuz öğelerin çıkışını alır.

Örnek 7: Dosya veya klasöre sembolik bağlantı oluşturma

Bu örnek, geçerli klasördeki Notice.txt dosyasına sembolik bir bağlantı oluşturur.

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

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

Bu örnekte Target , Value parametresinin diğer adıdır. Sembolik bağlantının hedefi göreli bir yol olabilir. PowerShell v6.2 sürümünden önce hedefin tam yol olması gerekir.

PowerShell 7.1'de başlayarak, artık göreli bir yol kullanarak Windows'taki bir klasöre SymbolicLink oluşturabilirsiniz.

Örnek 8: Klasörleri yeniden oluşturmak için -Force parametresini kullanın

Bu örnek, içinde dosya bulunan bir klasör oluşturur. Ardından, kullanarak -Forceaynı klasörü oluşturmayı dener. Klasörün üzerine yazılmaz, ancak var olan klasör nesnesini olduğu gibi oluşturulan dosyayla döndürür.

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

Örnek 9: Varolan dosyaların üzerine yazmak için -Force parametresini kullanın

Bu örnek, değeri olan bir dosya oluşturur ve ardından kullanarak -Forcedosyayı yeniden oluşturur. Bu, mevcut dosyanın üzerine yazar ve length özelliği tarafından görebileceğiniz gibi içeriğini kaybeder

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

Not

New-Item Kayıt defteri anahtarları oluşturmak için anahtarıyla kullanırken-Force, komut dosyanın üzerine yazılırken olduğu gibi davranır. Kayıt defteri anahtarı zaten varsa, anahtarın ve tüm özelliklerin ve değerlerin üzerine boş bir kayıt defteri anahtarı yazılır.

Parametreler

-ApplicationName

Bu, WSMan sağlayıcısı tarafından sağlanan dinamik bir parametredir. WSMan sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

Bağlantıdaki uygulama adını belirtir. ApplicationName parametresinin varsayılan değeri WSMAN'dır.

Daha fazla bilgi için bkz. New-WSManInstance.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Authentication

Bu, WSMan sağlayıcısı tarafından sağlanan dinamik bir parametredir. WSMan sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir.

Daha fazla bilgi için bkz. New-WSManInstance.

Type:	AuthenticationMechanism
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificateThumbprint

Bu, WSMan sağlayıcısı tarafından sağlanan dinamik bir parametredir. WSMan sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

Bu WSMan eylemini gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın sertifika parmak izini girin.

Daha fazla bilgi için bkz. New-WSManInstance.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionURI

Bu, WSMan sağlayıcısı tarafından sağlanan dinamik bir parametredir. WSMan sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

WSMan için bağlantı uç noktasını belirtir.

Daha fazla bilgi için bkz. New-WSManInstance.

Type:	Uri
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Credential

Not

Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Bu cmdlet'i çalıştırırken başka bir kullanıcının kimliğine bürünmek veya kimlik bilgilerinizi yükseltmek için kullanın Invoke-Command.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Bu cmdlet'i var olan bir salt okunur öğenin üzerine yazan bir öğe oluşturmaya zorlar. Uygulama sağlayıcıdan sağlayıcıya değişir. Force parametresi kullanıldığında bile, cmdlet güvenlik kısıtlamalarını geçersiz kılamaz.

Varolan bir Kavşağın üzerine yazmak için Zorla seçeneğini kullanamazsınız. Var olan bir Birleşimin üzerine yazma girişimleri "boş olmadığından kaldırılamıyor" hatasıyla başarısız oluyor. Yeni bir birleşim oluşturmadan önce mevcut Birleşim'i kaldırmanız gerekir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ItemType

Yeni öğenin sağlayıcı tarafından belirtilen türünü belirtir. Bu parametrenin kullanılabilir değerleri, kullandığınız geçerli sağlayıcıya bağlıdır.

Konumunuz bir FileSystem sürücüdeyse aşağıdaki değerlere izin verilir:

• File
• Directory
• SymbolicLink
• Birleşim
• Sabit Bağlantı

Not

Windows'da tür SymbolicLink oluşturmak için yönetici olarak yükseltme gerekir. Ancak, Geliştirici Modu etkin Windows 10 (derleme 14972 veya üzeri) artık sembolik bağlantılar oluşturmak için yükseltme gerektirmez.

Bir Certificate sürücüde, belirtebileceğiniz değerler şunlardır:

• Sertifika Sağlayıcısı
• Sertifika
• Depolama
• Storelocation

Daha fazla bilgi için bkz. about_Providers.

Type:	String
Aliases:	Type
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Yeni öğenin adını belirtir. Ad veya Yol parametresi değerinde yeni öğenin adını belirtebilir ve yeni öğenin yolunu Ad veya Yol değeri'nde belirtebilirsiniz. Ad parametresi kullanılarak geçirilen öğe adları, Path parametresinin değerine göre oluşturulur.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Options

Bu, Diğer Ad sağlayıcısı tarafından sağlanan dinamik bir parametredir. Daha fazla bilgi için bkz. Yeni Diğer Ad.

Diğer adın Options özelliğinin değerini belirtir.

Geçerli değerler:

• None: Diğer adın kısıtlaması yok (varsayılan değer)
• ReadOnly: Diğer ad silinebilir ancak Force parametresi kullanılmadan değiştirilemez
• Constant: Diğer ad silinemez veya değiştirilemez
• Private: Diğer ad yalnızca geçerli kapsamda kullanılabilir
• AllScope: Diğer ad, oluşturulan tüm yeni kapsamlara kopyalanır
• Unspecified: Seçenek belirtilmemiş

Type:	ScopedItemOptions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-OptionSet

Bu, WSMan sağlayıcısı tarafından sağlanan dinamik bir parametredir. WSMan sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

İsteğin niteliğini değiştirmek veya geliştirmek için bir dizi anahtarı bir hizmete geçirir.

Daha fazla bilgi için bkz. New-WSManInstance.

Type:	Hashtable
Aliases:	OS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

Yeni öğenin konumunun yolunu belirtir. Varsayılan, Yol atlandığında geçerli konumdur. Yeni öğenin adını Ad'da belirtebilir veya Yol'a ekleyebilirsiniz. Ad parametresi kullanılarak geçirilen öğe adları, Path parametresinin değerine göre oluşturulur.

Bu cmdlet için Path parametresi, diğer cmdlet'lerin LiteralPath parametresi gibi çalışır. Joker karakterler yorumlanmaz. Tüm karakterler konumun sağlayıcısına geçirilir. Sağlayıcı tüm karakterleri desteklemeyebilir. Örneğin, yıldız işareti (*) karakteri içeren bir dosya adı oluşturamazsınız.

Type:	String[]
Position:	0
Default value:	Current location
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

Bu, WSMan sağlayıcısı tarafından sağlanan dinamik bir parametredir. WSMan sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

İstemci WinRM hizmetine bağlanırken kullanılacak bağlantı noktasını belirtir.

Daha fazla bilgi için bkz. New-WSManInstance.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SessionOption

Bu, WSMan sağlayıcısı tarafından sağlanan dinamik bir parametredir. WSMan sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

WS-Management oturumu için bir dizi genişletilmiş seçenek tanımlar.

Daha fazla bilgi için bkz. New-WSManInstance.

Type:	SessionOption
Aliases:	SO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UseSSL

Bu, WSMan sağlayıcısı tarafından sağlanan dinamik bir parametredir. WSMan sağlayıcısı ve bu parametre yalnızca Windows'ta kullanılabilir.

Uzak bilgisayara bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolunun kullanılması gerektiğini belirtir. Varsayılan olarak SSL kullanılmaz.

Daha fazla bilgi için bkz. New-WSManInstance.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Value

Yeni öğenin değerini belirtir. Ayrıca bir değeri öğesine de yöneltebilirsiniz New-Item.

Type:	Object
Aliases:	Target
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

Object

Yeni öğe için bir değeri bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

Object

Bu cmdlet, oluşturduğu öğeyi döndürür.

Notlar

PowerShell için aşağıdaki diğer adları New-Itemiçerir:

• Tüm platformlar:
  • ni

New-Item herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için yazın Get-PsProvider. Daha fazla bilgi için bkz. about_Providers.

İlişkili Bağlantılar

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