Move-Item

  • Başvuru
Modül:
Microsoft.PowerShell.Management

Bir öğeyi bir konumdan diğerine taşır.

Syntax

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:\Temptest.txt olarak tst.txtyeniden 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-Itemgö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:\Textfilestaşı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-ChildItemForce 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\SoftwareMyNewCompany 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:1
Default value:Current directory
Required:False
Accept pipeline input:True
Accept wildcard characters: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 *.txtbir 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 *.txtbir 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Taşınan öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

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

-Path

Öğelerin geçerli konumunun yolunu belirtir. Geçerli dizin varsayılandır. Joker karakterlere izin verilir.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 için aşağıdaki diğer adları Move-Itemiç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.