Move-Item
Bir öğeyi bir konumdan diğerine taşır.
Syntax
Path (Varsayılan)
Move-Item
[-Path] <String[]>
[[-Destination] <String>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Move-Item
[[-Destination] <String>]
-LiteralPath <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<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 (Get-ChildItem) ile temsil edilen) ve . dosya adı uzantısına sahip alt dizinlerindeki tüm alt öğeleri almak için *.txt cmdlet'ini kullanır. Alma işlemini özyinelemeli yapmak için Yineleme parametresini ve alma işlemini dosyalarla sınırlamak için *.txt 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.
Uyarı
Windows PowerShell 2.0'da, cmdlet'in Get-ChildItem parametresi kullanılırken, Yolu parametresinin değeri bir kapsayıcı olmalıdır.
dosya adı uzantısı filtresini (*.txt) belirtmek için Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles parametresini kullanın.
Örnek 5: Kayıt defteri anahtarlarını ve değerlerini başka bir anahtara taşıma
Bu komut, MyCompanyHKLM\Software 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, [yerine ] 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.
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 |
-Credential
Uyarı
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.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | True |
| 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 |
-Destination
Öğelerin taşındığı konumun yolunu belirtir. Varsayılan değer geçerli dizindir. Joker karakterlere izin verilir, ancak sonuç tek bir konuma çözümlenmelidir.
Taşınan öğeyi yeniden adlandırmak için, Hedef parametresinin değerinde yeni bir ad belirtin.
Parametre özellikleri
| Tür: | String |
| Default value: | Current directory |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| 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 |
-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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| 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 |
-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özdizimini about_Wildcards'de 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| 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 |
-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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| 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 |
-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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| 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 |
-LiteralPath
Öğelerin geçerli konumunun 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, onu tek tırnak içine alın ('). Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.
Daha fazla bilgi için bkz. about_Quoting_Rules.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath |
Parametre kümeleri
LiteralPath
| 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 |
-PassThru
Taşınan öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| 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 |
-Path
Öğelerin geçerli konumunun yolunu belirtir. Varsayılan değer geçerli dizindir. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | Current directory |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Path
| Position: | 0 |
| Zorunlu: | True |
| İş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 |
-UseTransaction
Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz. about_Transactions.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | usetx |
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 |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
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
String
Bu cmdlet'e bir yolu içeren bir dizeyi 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
Windows PowerShell, Move-Itemiçin aşağıdaki diğer adları içerir:
mimovemvBu 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-Itemkomutu 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.
