Move-Item
Bir öğeyi bir konumdan diğerine taşır.
Sözdizimi
Move-Item
[-Path] <String[]>
[[-Destination] <String>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Move-Item
-LiteralPath <String[]>
[[-Destination] <String>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Move-Item
Cmdlet, özellikleri, içeriği ve alt öğeleri de dahil olmak üzere bir öğeyi bir konumdan başka bir konuma taşır. Konumlar aynı sağlayıcı tarafından desteklenmelidir.
Örneğin, bir dosyayı veya alt dizini bir dizinden diğerine taşıyabilir veya kayıt defteri alt anahtarını bir anahtardan diğerine taşıyabilir. Bir öğeyi taşıdığınızda, öğe yeni konuma eklenir ve özgün konumundan silinir.
Örnekler
Örnek 1: Dosyayı başka bir dizine taşıma ve yeniden adlandırma
Bu komut, dosyayı sürücüden dizinine taşır Test.txt
ve dosyasından E:\Temp
test.txt
olarak tst.txt
yeniden adlandırır.C:
Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt
Örnek 2: Bir dizini ve içeriğini başka bir dizine taşıma
Bu komut dizini ve içeriğini dizine C:\Logs
taşırC:\Temp
.
Dizin Temp
ve tüm alt dizinleri ve dosyaları dizinde Logs
görünür.
Move-Item -Path C:\Temp -Destination C:\Logs
Örnek 3: Belirtilen uzantının tüm dosyalarını geçerli dizinden başka bir dizine taşıma
Bu komut, geçerli dizindeki (nokta (*.txt
)) tüm metin dosyalarını (.
) dizine C:\Logs
taşır.
Move-Item -Path .\*.txt -Destination C:\Logs
Örnek 4: Belirtilen uzantının tüm dosyalarını geçerli dizinden başka bir dizine yinelemeli olarak taşıma
Bu komut, geçerli dizindeki tüm metin dosyalarını ve tüm alt dizinleri özyinelemeli olarak dizine C:\TextFiles
taşır.
Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"
komutu, geçerli dizindeki (nokta (.
)) ve dosya adı uzantısına sahip *.txt
alt dizinlerindeki tüm alt öğeleri almak için cmdlet'ini kullanırGet-ChildItem
. Alma işlemini özyinelemeli yapmak için Recurse parametresini ve alma işlemini dosyalarla sınırlamak *.txt
için Include parametresini kullanır.
İşlem hattı işleci (|
), bu komutun sonuçlarını dizinine Move-Item
gönderir ve bu da metin dosyalarını dizinine TextFiles
taşır.
Aynı ada Move-Item
sahip olacak şekilde taşınacak C:\Textfiles
dosyalar bir hata görüntüler ve devam ederse, ancak her ada sahip tek bir dosyayı öğesine C:\Textfiles
taşır. Diğer dosyalar özgün dizinlerinde kalır.
Textfiles
Dizin (veya hedef yolun başka bir öğesi) yoksa, komut başarısız olur. Force parametresini kullansanız bile eksik dizin sizin için oluşturulmaz. Move-Item
ilk öğeyi adlı Textfiles
bir dosyaya taşır ve dosyanın zaten var olduğunu açıklayan bir hata görüntüler.
Ayrıca, varsayılan olarak Get-ChildItem
gizli dosyaları taşımaz. Gizli dosyaları taşımak için ile Get-ChildItem
Force parametresini kullanın.
Not
Windows PowerShell 2.0'da, cmdlet'in Get-ChildItem
Özyineleme parametresi kullanılırken Path parametresinin değeri bir kapsayıcı olmalıdır. Dosya adı uzantısı filtresini *.txt
(Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles
) belirtmek için Include parametresini kullanın.
Örnek 5: Kayıt defteri anahtarlarını ve değerlerini başka bir anahtara taşıma
Bu komut, kayıt defteri anahtarındaki MyCompany
kayıt defteri anahtarlarını ve değerlerini anahtara HKLM\Software
MyNewCompany
taşır. Joker karakter (*
), anahtarın kendisinin değil, anahtarın MyCompany
içeriğinin taşınması gerektiğini belirtir. Bu komutta, isteğe bağlı Yol ve Hedef parametre adları atlanır.
Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"
Örnek 6: Bir dizini ve içeriğini belirtilen dizinin alt dizinine taşıma
Bu komut dizini (ve içeriğini) dizine Logs[2006]
taşırLogs[Sept`06]
.
Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'
Özgün dizin adı sol köşeli ayraç ve sağ köşeli ayraç karakterleri ([
ve ]
) içerdiğinden, Path yerine LiteralPath parametresi kullanılır. Yol aynı zamanda tek tırnak işareti ()'
içine alınır, böylece arka plan simgesi (`
) yanlış yorumlanmaz.
Yanlış yorumlanabilen köşeli ayraçlar içerdiğinden Destination parametresi de tek tırnak içine alınmalıdır.
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Credential
Not
Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Command kullanın.
Tür: | PSCredential |
Position: | Named |
Default value: | Current user |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Destination
Öğelerin taşındığı konumun yolunu belirtir. Geçerli dizin varsayılandır. Joker karakterlere izin verilmez.
Taşınan öğeyi yeniden adlandırmak için Hedef parametresinin değerinde yeni bir ad belirtin.
Tür: | String |
Position: | 1 |
Default value: | Current directory |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | True |
-Exclude
Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txt
bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi yalnızca komutu gibi C:\Windows\*
bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows
belirtir.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-Filter
Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtrelerin kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcards bulabilirsiniz. Filtreler diğer parametrelerden daha verimlidir, çünkü sağlayıcı, nesneleri aldıktan sonra PowerShell'in filtrelemesini yapmak yerine cmdlet nesneleri aldığında bunları uygular.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz . about_Providers.
Tür: | SwitchParameter |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Include
Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txt
bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi yalnızca komutu gibi C:\Windows\*
bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows
belirtir.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | True |
-LiteralPath
Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak işareti ('
içine alın). Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.
Daha fazla bilgi için bkz . about_Quoting_Rules.
Tür: | String[] |
Diğer adlar: | PSPath, LP |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-PassThru
Taşınan öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Tür: | SwitchParameter |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Path
Öğelerin geçerli konumunun yolunu belirtir. Geçerli dizin varsayılandır. Joker karakterlere izin verilir.
Tür: | String[] |
Position: | 0 |
Default value: | Current directory |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | True |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
Bu cmdlet'in yolunu içeren bir dizeyi kanala aktarabilirsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
PassThru parametresini kullandığınızda, bu cmdlet taşınan öğeyi temsil eden bir nesne döndürür.
Notlar
PowerShell için aşağıdaki diğer adları Move-Item
içerir:
Tüm platformlar:
mi
move
Windows:
mv
Bu cmdlet, dosyaları aynı sağlayıcı tarafından desteklenen sürücüler arasında taşır, ancak dizinleri yalnızca aynı sürücü içinde taşır.
Komut bir
Move-Item
öğenin özelliklerini, içeriğini ve alt öğelerini taşırken, tüm taşımalar varsayılan olarak özyinelemeli olur.Bu cmdlet, 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
PowerShell