Move-Item

Başvuru

Modül:: Microsoft.PowerShell.Management

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'i ö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 Test.txt dosyasını C: sürücüsünden E:\Temp dizinine taşır ve test.txttst.txtolarak yeniden adlandırır.

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, C:\Temp dizinini ve içeriğini C:\Logs dizinine taşır. Temp dizini ve tüm alt dizinleri ve dosyaları Logs dizininde 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 tüm metin dosyalarını (*.txt) (noktayla (.)) C:\Logs dizinine 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 C:\TextFiles dizinine taşır.

Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"

Komut, geçerli dizindeki (nokta (.) ile temsil edilen) ve *.txt dosya adı uzantısına sahip alt dizinlerindeki tüm alt öğeleri almak için Get-ChildItem cmdlet'ini kullanır. Alma işlemini özyinelemeli yapmak için Yineleme parametresini ve alma işlemini *.txt dosyalarla sınırlamak için Include parametresini kullanır.

İşlem hattı işleci (|), bu komutun sonuçlarını Move-Item'e gönderir ve bu da metin dosyalarını TextFiles dizinine taşır.

C:\Textfiles taşınacak dosyaların adı aynıysa, Move-Item bir hata görüntüler ve devam eder, ancak her ada sahip tek bir dosyayı C:\Textfiles. Diğer dosyalar özgün dizinlerinde kalır.

Textfiles dizini (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 Textfiles adlı bir dosyaya taşır ve dosyanın zaten var olduğunu açıklayan bir hata görüntüler.

Ayrıca, Get-ChildItem varsayılan olarak gizli dosyaları taşımaz. Gizli dosyaları taşımak için Force parametresini Get-ChildItemile kullanın.

Not

Windows PowerShell 2.0'da, Get-ChildItem cmdlet'in Yineleme parametresi kullanılırken, Yolu parametresinin değeri bir kapsayıcı olmalıdır. *.txt dosya adı uzantısı filtresini (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, HKLM\SoftwareMyCompany kayıt defteri anahtarındaki kayıt defteri anahtarlarını ve değerlerini MyNewCompany anahtarına taşır. Joker karakter (*), MyCompany anahtarının içeriğinin anahtarın kendisi değil 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 Logs[Sept`06] dizinini (ve içeriğini) Logs[2006] dizinine taşır.

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, Pathyerine LiteralPath parametresi kullanılır. Yol da tek tırnak işareti (') içine alınır, böylece arka plan simgesi (`) yanlış anlaşılmaz.

Hedef parametresi de yanlış yorumlanabilecek köşeli ayraçlar içerdiğinden 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-Commandkullanı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. Varsayılan değer geçerli dizindir. 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. *.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter C:\Windows dizininin içeriğini 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_Wildcardsbulabilirsiniz. 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. *.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi, yalnızca komut C:\Windows\*gibi bir öğenin içeriğini içerdiğinde ve joker karakteri C:\Windows dizininin içeriğini belirttiğinde etkilidir.

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ç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. Varsayılan değer geçerli dizindir. 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ırsa 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

String

Bu cmdlet'in yolunu içeren bir dizeyi kanala aktarabilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

PSObject

PassThru parametresini kullandığınızda, bu cmdlet taşınan öğeyi temsil eden bir nesne döndürür.

Notlar

PowerShell, Move-Itemiçin aşağıdaki diğer adları 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.
Move-Item komutu bir öğenin özelliklerini, içeriğini ve alt öğelerini taşıması nedeniyle, 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 Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.

Aracılığıyla paylaş