diff --git a/reference/5.1/Microsoft.PowerShell.Management/Move-Item.md b/reference/5.1/Microsoft.PowerShell.Management/Move-Item.md index 68263a10c5e..08744b18e9d 100644 --- a/reference/5.1/Microsoft.PowerShell.Management/Move-Item.md +++ b/reference/5.1/Microsoft.PowerShell.Management/Move-Item.md @@ -2,7 +2,7 @@ external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Management -ms.date: 02/26/2024 +ms.date: 04/01/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.management/move-item?view=powershell-5.1&WT.mc_id=ps-gethelp schema: 2.0.0 aliases: @@ -44,6 +44,11 @@ For example, it can move a file or subdirectory from one directory to another or subkey from one key to another. When you move an item, it is added to the new location and deleted from its original location. +If the specified destination path resolves to an existing non-container item, or you're moving and +the target name already exists, this cmdlet raises an error. To overwrite an existing item, use the +**Force** parameter. When the destination is an existing container (such as a directory), the item +is moved into that container, if supported by the provider. + ## EXAMPLES ### Example 1: Move a file to another directory and rename it diff --git a/reference/7.4/Microsoft.PowerShell.Management/Move-Item.md b/reference/7.4/Microsoft.PowerShell.Management/Move-Item.md index f999cba5144..6e3225e7cd4 100644 --- a/reference/7.4/Microsoft.PowerShell.Management/Move-Item.md +++ b/reference/7.4/Microsoft.PowerShell.Management/Move-Item.md @@ -2,7 +2,7 @@ external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Management -ms.date: 02/26/2024 +ms.date: 04/01/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.management/move-item?view=powershell-7.4&WT.mc_id=ps-gethelp schema: 2.0.0 aliases: @@ -44,6 +44,11 @@ For example, it can move a file or subdirectory from one directory to another or subkey from one key to another. When you move an item, it is added to the new location and deleted from its original location. +If the specified destination path resolves to an existing non-container item, or you're moving and +the target name already exists, this cmdlet raises an error. To overwrite an existing item, use the +**Force** parameter. When the destination is an existing container (such as a directory), the item +is moved into that container, if supported by the provider. + ## EXAMPLES ### Example 1: Move a file to another directory and rename it diff --git a/reference/7.5/Microsoft.PowerShell.Management/Move-Item.md b/reference/7.5/Microsoft.PowerShell.Management/Move-Item.md index b293f6c9b6e..06e53d5f78f 100644 --- a/reference/7.5/Microsoft.PowerShell.Management/Move-Item.md +++ b/reference/7.5/Microsoft.PowerShell.Management/Move-Item.md @@ -2,7 +2,7 @@ external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Management -ms.date: 02/26/2024 +ms.date: 04/01/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.management/move-item?view=powershell-7.5&WT.mc_id=ps-gethelp schema: 2.0.0 aliases: @@ -44,6 +44,11 @@ For example, it can move a file or subdirectory from one directory to another or subkey from one key to another. When you move an item, it is added to the new location and deleted from its original location. +If the specified destination path resolves to an existing non-container item, or you're moving and +the target name already exists, this cmdlet raises an error. To overwrite an existing item, use the +**Force** parameter. When the destination is an existing container (such as a directory), the item +is moved into that container, if supported by the provider. + ## EXAMPLES ### Example 1: Move a file to another directory and rename it diff --git a/reference/7.6/Microsoft.PowerShell.Management/Move-Item.md b/reference/7.6/Microsoft.PowerShell.Management/Move-Item.md index a27fe5f2c33..51de86e9fa7 100644 --- a/reference/7.6/Microsoft.PowerShell.Management/Move-Item.md +++ b/reference/7.6/Microsoft.PowerShell.Management/Move-Item.md @@ -2,7 +2,7 @@ external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Management -ms.date: 02/26/2024 +ms.date: 04/01/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.management/move-item?view=powershell-7.6&WT.mc_id=ps-gethelp schema: 2.0.0 aliases: @@ -44,6 +44,12 @@ For example, it can move a file or subdirectory from one directory to another or subkey from one key to another. When you move an item, it is added to the new location and deleted from its original location. +If the specified destination path resolves to an existing non-container item, or you're moving and +the target name already exists, this cmdlet raises an error. To overwrite an existing item, use the +**Force** parameter. When the destination is an existing container (such as a directory), the item +is moved into that container, if supported by the provider. +provider. + ## EXAMPLES ### Example 1: Move a file to another directory and rename it