Condividi tramite

Move-Item

Modulo:
Microsoft.PowerShell.Management Module

Sposta un elemento da una posizione a un'altra.

Sintassi

Path (impostazione predefinita). 

Move-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath 

Move-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Move-Item sposta un elemento, incluse le proprietà, il contenuto e gli elementi figlio, da una posizione a un'altra. I percorsi devono essere supportati dallo stesso provider.

Ad esempio, può spostare un file o una sottodirectory da una directory a un'altra o spostare una sottochiave del Registro di sistema da una chiave a un'altra. Quando si sposta un elemento, questo viene aggiunto alla nuova posizione ed eliminato dalla posizione originale.

Esempio

Esempio 1: Spostare un file in un'altra directory e rinominarlo

Questo comando sposta il file Test.txt dall'unità C: alla directory E:\Temp e lo rinomina da test.txt a tst.txt.

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

Esempio 2: Spostare una directory e il relativo contenuto in un'altra directory

Questo comando sposta la directory C:\Temp e il relativo contenuto nella directory C:\Logs. La directory Temp e tutti i relativi file e sottodirectory vengono quindi visualizzati nella directory Logs.

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

Esempio 3: Spostare tutti i file di un'estensione specificata dalla directory corrente a un'altra directory

Questo comando sposta tutti i file di testo (*.txt) nella directory corrente (rappresentata da un punto (.)) nella directory C:\Logs.

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

Esempio 4: Spostare in modo ricorsivo tutti i file di un'estensione specificata dalla directory corrente a un'altra directory

Questo comando sposta tutti i file di testo dalla directory corrente e tutte le sottodirectory, in modo ricorsivo, alla directory C:\TextFiles.

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

Il comando usa il cmdlet Get-ChildItem per ottenere tutti gli elementi figlio nella directory corrente (rappresentata dal punto (.)) e le relative sottodirectory con estensione *.txt nome file. Usa il parametro Recurse per rendere ricorsivo il recupero e il parametro Includi per limitare il recupero ai file *.txt.

L'operatore pipeline (|) invia i risultati di questo comando a Move-Item, che sposta i file di testo nella directory TextFiles.

Se i file da spostare in C:\Textfiles hanno lo stesso nome, Move-Item visualizza un errore e continua, ma sposta un solo file con ogni nome in C:\Textfiles. Gli altri file rimangono nelle directory originali.

Se la directory Textfiles (o qualsiasi altro elemento del percorso di destinazione) non esiste, il comando non riesce. La directory mancante non viene creata automaticamente, anche se si usa il parametro force . Move-Item sposta il primo elemento in un file denominato Textfiles e quindi visualizza un errore che spiega che il file esiste già.

Inoltre, per impostazione predefinita, Get-ChildItem non sposta i file nascosti. Per spostare i file nascosti, usare il parametro Force con Get-ChildItem.

Annotazioni

In Windows PowerShell 2.0, quando si usa il parametro Recurse del cmdlet Get-ChildItem, il valore del parametro percorso deve essere un contenitore. Usare il parametro Includi per specificare il filtro dell'estensione del nome file *.txt (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

Esempio 5: Spostare chiavi e valori del Registro di sistema in un'altra chiave

Questo comando sposta le chiavi e i valori del Registro di sistema all'interno della chiave del Registro di sistema MyCompany in HKLM\Software alla chiave MyNewCompany. Il carattere jolly (*) indica che il contenuto della chiave MyCompany deve essere spostato, non la chiave stessa. In questo comando vengono omessi i nomi dei parametri Path e Destination.

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

Esempio 6: Spostare una directory e il relativo contenuto in una sottodirectory della directory specificata

Questo comando sposta la directory Logs[Sept`06] (e il relativo contenuto) nella directory Logs[2006].

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'

Il parametro LiteralPath viene usato invece di Path, perché il nome della directory originale include parentesi quadre e parentesi quadre destra ([ e ]). Il percorso è racchiuso tra virgolette singole ('), in modo che il simbolo di backtick (`) non venga interpretato erroneamente.

Il parametro destination deve essere racchiuso tra virgolette singole perché include parentesi quadre che possono essere interpretate in modo non corretto.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Credential

Annotazioni

Questo parametro non è supportato da alcun provider installato con PowerShell. Per rappresentare un altro utente o elevare le credenziali quando si esegue questo cmdlet, usare Invoke-Command.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:Current user
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Destination

Specifica il percorso della posizione in cui vengono spostati gli elementi. Il valore predefinito è la directory corrente. I caratteri jolly non sono consentiti.

Per rinominare l'elemento da spostare, specificare un nuovo nome nel valore del parametro Destination.

Proprietà dei parametri

Tipo:String
Valore predefinito:Current directory
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Exclude

Specifica, come array di stringhe, uno o più elementi che questo cmdlet esclude durante l'operazione. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o un modello di percorso, ad esempio *.txt. Sono consentiti caratteri jolly. Il parametro Exclude è valido solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, nel quale il carattere jolly specifica il contenuto della directory C:\Windows.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Filter

Specifica un filtro per qualificare il parametro Path. Il provider di FileSystem è l'unico provider di PowerShell installato che supporta l'utilizzo dei filtri. È possibile trovare la sintassi del linguaggio di filtro FileSystem in about_Wildcards. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica quando il cmdlet ottiene gli oggetti anziché filtrare gli oggetti dopo il recupero.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Forza l'esecuzione del comando senza chiedere conferma dell'utente. L'implementazione varia da provider a provider. Per altre informazioni, consultare about_Providers.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Include

Specifica, sotto forma di matrice di stringhe, un elemento o elementi che questo cmdlet include nell'operazione. Il valore di questo parametro qualifica il parametro Path. Immettere un elemento o un modello di percorso, ad esempio *.txt. Sono consentiti caratteri jolly. Il parametro Include è efficace solo quando il comando include il contenuto di un elemento, ad esempio C:\Windows\*, dove il carattere jolly specifica il contenuto della directory C:\Windows.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LiteralPath

Specifica un percorso per una o più posizioni. Il valore di LiteralPath viene utilizzato esattamente come viene digitato. Nessun carattere viene interpretato come metacaratteri. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole ('). Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Per altre informazioni, vedere about_Quoting_Rules.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:PSPath, UP

Set di parametri

LiteralPath
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento spostato. Per impostazione predefinita, questo cmdlet non genera alcun output.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Path

Specifica il percorso della posizione corrente degli elementi. Il valore predefinito è la directory corrente. Sono consentiti caratteri jolly.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:Current directory
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

Path
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

È possibile inviare tramite pipe una stringa contenente un percorso a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

PSObject

Quando si usa il parametro passThru, questo cmdlet restituisce un oggetto che rappresenta l'elemento spostato.

Note

PowerShell include gli alias seguenti per Move-Item:

  • Tutte le piattaforme:

    • mi
    • move

  • Windows:

    • mv

  • Questo cmdlet sposta i file tra unità supportate dallo stesso provider, ma sposta le directory solo all'interno della stessa unità.

  • Poiché un comando Move-Item sposta le proprietà, il contenuto e gli elementi figlio di un elemento, tutti gli spostamenti vengono ricorsivi per impostazione predefinita.

  • Questo cmdlet è progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PSProvider. Per altre informazioni, consultare about_Providers.