Move-Item

joulu 18, 2021
Module: Microsoft.PowerShell.Management

Siirtaa kohteen paikasta toiseen.

Syntaksi

Kuvaus

Move-ItemCmdlet Move-Itemsiirtää kohteen, mukaan lukien sen ominaisuudet, sisällön ja alialkuiset kohteet, jostain sijaintipaikasta toiseen. Sijaintien on oltava saman palveluntarjoajan tukemia.Sillä voidaan esimerkiksi siirtää tiedosto tai alihakemisto hakemistosta toiseen tai siirtää rekisteriavain avaimesta toiseen.Kun siirrät kohteen, se lisätään uuteen sijaintiin ja poistetaan alkuperäisestä sijainnista.

Esimerkkejä

Esimerkki 1: Siirrä tiedosto toiseen hakemistoon ja nimeä se uudelleen

Tällä komennolla siirretään tiedosto Test.txt asemalta C: hakemistoon E:\Temp ja nimetään se uudelleenhakemistosta test.txt muotoon tst.txt.

Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt

Esimerkki 2: Hakemiston ja sen sisällön siirtäminen toiseen hakemistoon

Tällä komennolla siirretään hakemisto C:\Temp ja sen sisältö hakemistoon C:\Logs. ”Temp”-hakemisto ja kaikki sen alihakemistot ja tiedostot näkyvät tällöin ”Logs”-hakemistossa.

Move-Item -Path C:\Temp -Destination C:\Logs

Esimerkki 3: Siirrä kaikki määritellyn laajennuksen tiedostot nykyisestä hakemistosta toiseen hakemistoon

Tämä komento siirtää kaikki nykyisessä hakemistossa olevat tekstitiedostot (*.txt) (joita edustaa piste(.)) hakemistoon C:\Logs.

Move-Item -Path .\*.txt -Destination C:\Logs

Esimerkki 4: Siirrä rekursiivisesti kaikki määritetyn laajennuksen tiedostot nykyisestä hakemistosta toiseen hakemistoon

Tämä komento siirtää kaikki tekstitiedostot nykyisestä hakemistosta ja kaikista alihakemistoista,rekursiivisesti, hakemistoon ”C:\TextFiles”.

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

Komento hakee Get-ChildItem-komentokomennolla kaikki nykyisen hakemiston(pisteellä esitetyt ) ja sen alihakemistojen lapsikohteet, joissa on ”.Se käyttää Recurse-parametria, jotta haku on rekursiivinen, ja Include-parametria, jotta haku voidaan rajoittaa vain ”.txt”-tiedostoihin.

Putkioperaattori (|) lähettää tämän komennon tulokset komentoon Move-Item, joka siirtää tekstitiedostot hakemistoon ”TextFiles”.

Jos ”C:\Textfiles” -hakemistoon siirrettävillä tiedostoilla on sama nimi, Move-Item näyttää virheilmoituksenja jatkaa, mutta se siirtää vain yhden tiedoston, jolla on sama nimi, ”C:\Textfiles” -hakemistoon.Muut tiedostot pysyvät alkuperäisissä hakemistoissaan.

Jos ”Textfiles”-hakemistoa (tai muuta kohdepolun elementtiä) ei ole olemassa, komento epäonnistuu.Puuttuvaa hakemistoa ei luoda puolestasi, vaikka käyttäisitkin Force-parametria.Move-Item siirtää ensimmäisen elementin ”Textfiles”-nimiseen tiedostoon ja näyttää sitten virheilmoituksen, jossa selitetään, että tiedosto on jo olemassa.

Myös oletusarvoisesti Get-ChildItem ei siirrä piilotettuja tiedostoja.Jos haluat siirtää piilotettuja tiedostoja, käytä Force-parametria yhdessä Get-ChildItem:n kanssa.

Huomautus

Windows PowerShell 2.0, kun käytetään Get-ChildItem-komentokomennon Recurse-parametria, Path-parametrin arvon on oltava säiliö.Käytä Include-parametria määritelläksesi .txt-tiedostonimen laajennussuodattimen(Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

Esimerkki 5: Siirrä rekisteriavaimet ja -arvot toiseen avaimeen

Komennolla siirretään rekisteriavainten ja -arvojen rekisteriavaimet ja -arvot, jotka sijaitsevat rekisteriavaimessaHKLM\Software ”OmaYritys”, rekisteriavaintaHKLM\Software kohti avaimessa

”OmaUusiResurssiyhtiö”.Jokerimerkki (*) osoittaa, että ”MyCompany”-avaimen sisältö siirretään, ei itse avainta.Tässä komennossa valinnaiset Path- ja Destination-parametrien nimet jätetään pois.

Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"

Esimerkki 6: Siirrä hakemisto ja sen sisältö määritellyn hakemiston alihakemistoon

Tällä komennolla siirretään hakemisto ”Lokeja”-hakemisto (sisältöineen) hakemistoon ”Logs”.

Move-Item -LiteralPath 'Logs' -Destination 'Logs'

LiteralPath-parametria käytetään Path-parametrin sijasta, koska alkuperäinen hakemistonimi sisältää vasen- ja oikeanpuoleisia hakasulku-merkkejä (””).Polku on myös suljettu yksinkertaisiin lainausmerkkeihin (’ ’), jotta takaviivamerkkiä (`) ei tulkittaisi väärin.

Kohde-parametri ei vaadi kirjaimellista polkua, koska myös Kohde-muuttuja on suljettava yksinkertaisiin lainausmerkkeihin, koska se sisältää hakasulkeita, joita voidaan tulkita väärin.

Parametrit

Vahvistus

Pyytää vahvistusta ennen komentotehtävän suorittamista.

Type: SwitchParameter
Aliases: cf
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Credential

Huomautus

Tämä parametri ei ole tuettu yhdessäkään palveluntarjoajassa, joka on asennettu PowerShellillä.Jos haluat esiintyä toisena käyttäjänä tai korottaa tunnistetietojasi tätä komentoa suorittaessasi,käytä Invoke-Command.

Type: PSCredential
Position: Named
Default value: Current user
Accept pipeline input: True
Accept wildcard characters: False
-Destination

Määrittää polun paikkaan, johon kohteet siirretään.Oletusarvo on nykyinen hakemisto.Jokerimerkit ovat sallittuja, mutta tuloksen on määritettävä yksi sijainti.

Jos haluat nimetä siirrettävän kohteen uudelleen, määritä uusi nimi Destination-parametrin arvoon.

Tyyppi: merkkijono
Sijainti: 1
Oletusarvo: Virtainen hakemisto
Hyväksyttiin putkistosyöttö: True
Accept wildcard characters: True

-Exclude

Määrittää merkkijonojoukkona kohteen tai kohteet, jotka tämä komentojono sulkee pois operaatiosta. Tämän parametrin arvo määrittää Path-parametrin. Anna polkuelementti tai -kuvio, kuten *.txt. Jokerimerkit ovat sallittuja. Exclude-parametri on voimassa vain, kun komento sisältää kohteen sisällön, kuten C:\Windows\*, jossa jokerimerkki määrittelee C:\Windows-hakemiston sisällön.

Tyyppi: Merkkijono
Positio: Nimetty
Oletusarvo: Ei mitään
Hyväksytään putkiston syöttö: False
Accept wildcard characters: True
-Filter

Määrittää suodattimen Path-parametrin karsimiseksi. FileSystemprovider on ainoa asennettu PowerShell-palveluntarjoaja, joka tukee suodattimien käyttöä. FileSystem-suodatinkielen syntaksin löydät kohdasta about_Wildcards.Suodattimet ovat tehokkaampia kuin muut parametrit, koska palveluntarjoaja soveltaa niitä, kun cmdlettaa objekteja sen sijaan, että PowerShell suodattaa objekteja niiden noutamisen jälkeen.

Type: String
Position: Named
Default value: None
Esimerkkitieto: False
Accept wildcard characters: True
-Force

Pakottaa komennon suorittamaan kysymättä käyttäjän vahvistusta.Toteutus vaihtelee palveluntarjoajittain.Lisätietoja on kohdassa about_Providers.

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

Määrittää merkkijonojoukkona kohteen tai kohteet, jotka tämä cmdlet sisällyttää toimintoon. Tämän parametrin arvo määrittää Path-parametrin. Anna polkuelementti tai -kuvio, kuten"*.txt". Jokerimerkit ovat sallittuja. Include-parametri on voimassa vain, kun komento sisältää kohteen sisällön, kuten C:\Windows\*, jossa jokerimerkki määrittelee C:\Windows-hakemiston sisällön.

Tyyppi: Merkkijono
Positio: Nimetty
Oletusarvo: Ei mitään
Linjan syöttö hyväksytty: False
Accept wildcard characters: True
-LiteralPath

Määrittää polun yhteen tai useampaan paikkaan. LiteralPathin arvoa käytetään täsmälleen sellaisena kuin se on kirjoitettu. Merkkejä ei tulkita jokerimerkkeinä. Jos polku sisältää pakomerkkejä, sulje se yksinkertaisiin lainausmerkkeihin. Yksinkertaiset lainausmerkit kertovat PowerShellille, ettei se tulkitse merkkejä pakosarjoiksi.

Lisätietoja on kohdassa about_Quoting_Rules.

Type: String
Aliases: PSPath, LP
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
-PassThru

Palauttaa objektin, joka edustaa kohdetta, jonka kanssa työskentelet.Oletusarvoisesti tämä cmdlet ei tuota mitään tulostetta.

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

Määrittää polun kohteiden nykyiseen sijaintiin.Oletuksena on nykyinen hakemisto.Jokerimerkit ovat sallittuja.

Tyyppi: Merkkijono
Sijainti: 0
Oletusarvo: Virtainen hakemisto
Hyväksytään putkiston syöttö: True
Accept wildcard characters: True
-WhatIf

Näyttää, mitä tapahtuisi, jos komentotehtävä suoritetaan.Cmdletia ei suoriteta.

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

Syötteet

String

Voit putkella merkkijonon, joka sisältää polun, tälle komennolle.

Tulosteet

Ei mitään tai siirrettyä kohdetta edustava objekti

Kun käytät PassThru -parametria, tämä cmdlet tuottaa siirrettyä kohdetta edustavan objektin.Muussa tapauksessa tämä cmdlet ei tuota mitään tulostetta.

Huomautuksia

  • Tämä cmdlet siirtää tiedostoja saman palveluntarjoajan tukemien asemien välillä, mutta se siirtäähakemistoja vain saman aseman sisällä.
  • Koska Move-Item-komennolla siirretään kohteen ominaisuuksia, sisältöjä ja alittavia kohteita, kaikki siirrot ovat oletusarvoisesti rekursiivisia.
  • Tämä cmdlet on suunniteltu työskentelemään minkä tahansa palveluntarjoajan tarjoamien tietojen kanssa.Voit luetella istunnossa käytettävissä olevat palveluntarjoajat kirjoittamalla Get-PSProvider.Lisätietoja on kohdassa about_Providers.
  • Clear-Item
  • Copy-Item
  • Get-Item
  • Invoke-Item
  • New-Item
  • Remove-Item
  • Rename-Item
  • Set-Item
  • tietoa_Palvelujen tarjoajista

Vastaa

Sähköpostiosoitettasi ei julkaista.