New-Item

Modül:

Microsoft.PowerShell.Management Module

Yeni bir öğe oluşturur.

Sözdizimi

pathSet (Default) - All providers

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

nameSet - All providers

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

pathSet (Default) - WSMan provider

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

nameSet - WSMan provider

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

pathSet (Default) - Alias provider

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

nameSet - Alias provider

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ör oluşturur. Kayıt defterinde New-Item kayıt 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. Yolu 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, C: sürücüsünde "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, $PROFILE değişkeni tarafından 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 yoktur.

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", Namedeğ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. Yol birden çok dize aldığından, bunu kullanarak birden çok öğe oluşturabilirsiniz.

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

New-Item cmdlet'i, Path parametresindeki joker karakterleri destekler. Aşağıdaki komut, temp.txt parametresinde joker karakterler tarafından belirtilen tüm dizinlerde bir dosyası 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

Get-ChildItem cmdlet'i, C:\Temp dizininin altında üç dizin gösterir. Joker karakterler kullanıldığında, New-Item cmdlet'i geçerli dizinin altındaki tüm dizinlerde bir temp.txt dosyası oluşturur. New-Item cmdlet'i, yeni oluşturulan dosyaların yollarını doğrulamak için Select-Object yöneltilen, oluşturduğunuz öğelerin çıkışını oluşturur.

Ö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 hedef , Değeri 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, 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, -Forcekullanarak aynı 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 Zorla parametresini kullanın

Bu örnek, değeri olan bir dosya oluşturur ve sonra Force parametresini kullanarak dosyayı yeniden oluşturur. Bu, Uzunluğu özelliğinde görebileceğiniz gibi var olan dosyanın üzerine yazar.

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

Uyarı

Kayıt defteri anahtarlarını oluşturmak için New-Item parametresiyle kullanırken, 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 değeridir.

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

nameSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 .

Parametre özellikleri

Tür:	AuthenticationMechanism
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 parmak izini girin.

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Confirm

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 .

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

pathSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Credential

Uyarı

Bu parametre, PowerShell ile yüklenen sağlayıcılar 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 Invoke-Commandkullanın.

Parametre özellikleri

Tür:	PSCredential
Default value:	Current user
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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. cmdletForce parametresini kullanarak bile güvenlik kısıtlamalarını geçersiz kılamaz.

PowerShell 7.4'den başlayarak, bu parametre var olan bir Birleşimin üzerine yazmanızı da sağlar. Daha önce bu durum "boş olmadığından kaldırılamıyor" hatasıyla başarısız olacaktı.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 FileSystem bir sürücüdeyse aşağıdaki değerlere izin verilir:

• File
• Directory
• SymbolicLink
• Junction
• HardLink

Uyarı

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

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

• Certificate Provider
• Certificate
• Store
• StoreLocation

Daha fazla bilgi için bkz. about_Providers.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Türü

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Name

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

nameSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Options

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

Bir diğer adın Seçenekler özelliğinin değerini belirtir.

Geçerli değerler şunlardır:

• None: Takma adın herhangi bir kısıtlaması yok (varsayılan değer)
• ReadOnly: Diğer ad silinebilir ancak Zorla parametresi kullanılmadıkça değiştirilemez.
• Constant: Bu diğer ad silinemez ve değiştirilemez
• Private: Diğer ad yalnızca mevcut kapsamda kullanılabilir
• AllScope: Diğer ad, oluşturulan tüm yeni kapsamlara kopyalanır
• Unspecified: Seçenek belirtilmemiş

Parametre özellikleri

Tür:	ScopedItemOptions
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 iyileştirmek için bir dizi anahtarı bir hizmete geçirir.

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

Parametre özellikleri

Tür:	Hashtable
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	işletim sistemi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Path

Yeni öğenin konumunun yolunu belirtir. Varsayılan, Yol atlandığında geçerli konumdur. yeni öğenin adını Nameiçinde belirtebilir veya Yolekleyebilirsiniz. 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 (*) karakteri içeren bir dosya adı oluşturamazsınız.

Parametre özellikleri

Tür:	String[]
Default value:	Current location
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

pathSet

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

nameSet

Position:	0
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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ğlandığında kullanılacak bağlantı noktasını belirtir.

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

Parametre özellikleri

Tür:	Int32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 .

Parametre özellikleri

Tür:	SessionOption
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	ÖYLE

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 .

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

nameSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Value

Yeni öğenin değerini belirtir. Bir değeri New-Item'e de yöneltebilirsiniz.

Parametre özellikleri

Tür:	Object
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Hedef

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

Object

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

Çıkışlar

DictionaryEntry

Cmdlet, yeni bir ortam değişkeni oluştururken bir DictionaryEntry nesnesi döndürür.

DirectoryInfo

Cmdlet, dosya sisteminde yeni bir dizin oluştururken bir DirectoryInfo nesnesi döndürür.

FileInfo

Cmdlet, dosya sisteminde yeni bir dosya oluştururken bir FileInfo nesnesi döndürür.

AliasInfo

Cmdlet, yeni bir diğer ad oluştururken bir AliasInfo nesnesi döndürür.

FunctionInfo

Cmdlet, yeni bir işlev oluştururken bir FunctionInfo nesnesi döndürür.

PSVariable

Cmdlet, yeni bir değişken oluştururken PSVariable nesnesi döndürür.

Notlar

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

• Tüm platformlar:
  • ni

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

İlişkili Bağlantılar

• Öğe Temizle
• Öğe Kopyala
• Get-Item
• Invoke-Item
• Öğeyi Taşı
• Ögeyi Kaldır
• Öğeyi Yeniden Adlandır
• Set-Item komutu
• Sağlayıcılar_Hakkında