From 522ea7ed2f8f57b431ed562462a6d7a17d89ace1 Mon Sep 17 00:00:00 2001 From: David Smatlak Date: Mon, 24 Jun 2019 16:28:13 -0700 Subject: [PATCH] fixed sentence, copyedits (#4475) --- .../Clear-RecycleBin.md | 71 ++++++++++------- .../Clear-RecycleBin.md | 76 ++++++++++++------- 2 files changed, 90 insertions(+), 57 deletions(-) diff --git a/reference/5.0/Microsoft.PowerShell.Management/Clear-RecycleBin.md b/reference/5.0/Microsoft.PowerShell.Management/Clear-RecycleBin.md index 99c863d1a921..6ba19c9cd2e5 100644 --- a/reference/5.0/Microsoft.PowerShell.Management/Clear-RecycleBin.md +++ b/reference/5.0/Microsoft.PowerShell.Management/Clear-RecycleBin.md @@ -1,5 +1,5 @@ --- -ms.date: 06/09/2017 +ms.date: 6/24/2019 schema: 2.0.0 locale: en-us keywords: powershell,cmdlet @@ -7,6 +7,7 @@ online version: https://go.microsoft.com/fwlink/?linkid=821571 external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml title: Clear-RecycleBin --- + # Clear-RecycleBin ## SYNOPSIS @@ -14,54 +15,67 @@ Clears the contents of a recycle bin. ## SYNTAX +### All + ``` Clear-RecycleBin [[-DriveLetter] ] [-Force] [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION -The Clear-RecycleBin cmdlet deletes the content of a recycle bin. Running this cmdlet is equivalent to the "Empty Recycle Bin" action. +The `Clear-RecycleBin` cmdlet deletes the content of a computer's recycle bin. This action is like +using Windows **Empty Recycle Bin**. ## EXAMPLES ### 1: Clear all recycle bins +In this example, all the local computer's recycle bins are cleared. + +```powershell +Clear-RecycleBin ``` -PS C:\> Clear-RecycleBin + +```Output +Confirm +Are you sure you want to perform this action? +Performing the operation "Clear-RecycleBin" on target "All of the contents of the Recycle Bin". +[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): ``` -This command will clear all recycle bins present on the local computer. -the command will prompt for user confirmation before execution. -### 2: Clear single recycle bin +`Clear-RecycleBin` prompts the user for confirmation to clear all recycle bins on the local +computer. +### 2: Clear a specified recycle bin + +This example clears the recycle bin for a specified drive letter. + +```powershell +Clear-RecycleBin -DriveLetter C ``` -PS C:\> Clear-RecycleBin -DriveLetter C -``` -This command will clear the recycle bin on the volume with the C drive letter. -This command will not work on -The command will prompt for user confirmation before execution. + +`Clear-RecycleBin` uses the **DriveLetter** parameter to specify the recycle bin on the **C** +volume. The user is prompted for confirmation to run the command. ### 3: Clear all recycle bins without confirmation +This example doesn't prompt for confirmation to clear the local computer's recycle bins. + +```powershell +Clear-RecycleBin -Force ``` -PS C:\> Clear-RecycleBin -Force -``` -This command will clear the recycle bin on the volume with the C drive letter. -The command will NOT prompt for user confirmation before execution. -### 3: Clear all recycle bins without confirmation (alternative) +`Clear-RecycleBin` uses the **Force** parameter and doesn't prompt the user for confirmation to +clear all recycle bins on the local computer. -``` -PS C:\> Clear-RecycleBin -Confirm:$false -``` -This command will clear the recycle bin on the volume with the C drive letter. -The command will NOT prompt for user confirmation before execution. +An alternative is to replace `-Force` with `-Confirm:$false`. ## PARAMETERS ### -Confirm -Prompts you for confirmation before running the cmdlet. +Prompts for user confirmation before running the cmdlet. The user is prompted for confirmation even +if the **Confirm** parameter isn't specified. ```yaml Type: SwitchParameter @@ -77,7 +91,7 @@ Accept wildcard characters: False ### -DriveLetter -Specifies an array of drive letters for which this cmdlet clears the recycle bin. +Specifies the recycle bin to clear for a single drive letter or an array of drive letters. ```yaml Type: String[] @@ -93,7 +107,7 @@ Accept wildcard characters: False ### -Force -Forces the command to run without asking for user confirmation. +Specifies that the user isn't prompted for confirmation to clear a recycle bin. ```yaml Type: SwitchParameter @@ -109,8 +123,7 @@ Accept wildcard characters: False ### -WhatIf -Shows what would happen if the cmdlet runs. -The cmdlet is not run. +Shows what would happen if `Clear-RecycleBin` runs. The cmdlet isn't run. ```yaml Type: SwitchParameter @@ -126,7 +139,9 @@ Accept wildcard characters: False ### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216). +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, +-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, +-WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -134,4 +149,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## NOTES -## RELATED LINKS +## RELATED LINKS \ No newline at end of file diff --git a/reference/5.1/Microsoft.PowerShell.Management/Clear-RecycleBin.md b/reference/5.1/Microsoft.PowerShell.Management/Clear-RecycleBin.md index d998854632f6..ad9a4fde4203 100644 --- a/reference/5.1/Microsoft.PowerShell.Management/Clear-RecycleBin.md +++ b/reference/5.1/Microsoft.PowerShell.Management/Clear-RecycleBin.md @@ -3,7 +3,7 @@ external help file: Microsoft.PowerShell.Commands.Management.dll-Help.xml keywords: powershell,cmdlet locale: en-us Module Name: Microsoft.PowerShell.Management -ms.date: 06/09/2017 +ms.date: 6/24/2019 online version: https://go.microsoft.com/fwlink/?linkid=821571 schema: 2.0.0 title: Clear-RecycleBin @@ -12,58 +12,70 @@ title: Clear-RecycleBin # Clear-RecycleBin ## SYNOPSIS - Clears the contents of a recycle bin. ## SYNTAX +### All + ``` Clear-RecycleBin [[-DriveLetter] ] [-Force] [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION -The Clear-RecycleBin cmdlet deletes the content of a recycle bin. Running this cmdlet is equivalent to the "Empty Recycle Bin" action. +The `Clear-RecycleBin` cmdlet deletes the content of a computer's recycle bin. This action is like +using Windows **Empty Recycle Bin**. ## EXAMPLES ### 1: Clear all recycle bins + +In this example, all the local computer's recycle bins are cleared. + +```powershell +Clear-RecycleBin ``` -PS C:\> Clear-RecycleBin + +```Output +Confirm +Are you sure you want to perform this action? +Performing the operation "Clear-RecycleBin" on target "All of the contents of the Recycle Bin". +[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): ``` -This command will clear all recycle bins present on the local computer. -the command will prompt for user confirmation before execution. +`Clear-RecycleBin` prompts the user for confirmation to clear all recycle bins on the local +computer. -### 2: Clear single recycle bin -``` -PS C:\> Clear-RecycleBin -DriveLetter C +### 2: Clear a specified recycle bin + +This example clears the recycle bin for a specified drive letter. + +```powershell +Clear-RecycleBin -DriveLetter C ``` -This command will clear the recycle bin on the volume with the C drive letter. -This command will not work on -The command will prompt for user confirmation before execution. +`Clear-RecycleBin` uses the **DriveLetter** parameter to specify the recycle bin on the **C** +volume. The user is prompted for confirmation to run the command. ### 3: Clear all recycle bins without confirmation -``` -PS C:\> Clear-RecycleBin -Force -``` -This command will clear the recycle bin on the volume with the C drive letter. -The command will NOT prompt for user confirmation before execution. +This example doesn't prompt for confirmation to clear the local computer's recycle bins. -### 3: Clear all recycle bins without confirmation (alternative) -``` -PS C:\> Clear-RecycleBin -Confirm:$false +```powershell +Clear-RecycleBin -Force ``` -This command will clear the recycle bin on the volume with the C drive letter. -The command will NOT prompt for user confirmation before execution. +`Clear-RecycleBin` uses the **Force** parameter and doesn't prompt the user for confirmation to +clear all recycle bins on the local computer. + +An alternative is to replace `-Force` with `-Confirm:$false`. ## PARAMETERS ### -DriveLetter -Specifies an array of drive letters for which this cmdlet clears the recycle bin. + +Specifies the recycle bin to clear for a single drive letter or an array of drive letters. ```yaml Type: String[] @@ -78,7 +90,8 @@ Accept wildcard characters: False ``` ### -Force -Forces the command to run without asking for user confirmation. + +Specifies that the user isn't prompted for confirmation to clear a recycle bin. ```yaml Type: SwitchParameter @@ -93,7 +106,9 @@ Accept wildcard characters: False ``` ### -Confirm -Prompts you for confirmation before running the cmdlet. + +Prompts for user confirmation before running the cmdlet. The user is prompted for confirmation even +if the **Confirm** parameter isn't specified. ```yaml Type: SwitchParameter @@ -108,8 +123,8 @@ Accept wildcard characters: False ``` ### -WhatIf -Shows what would happen if the cmdlet runs. -The cmdlet is not run. + +Shows what would happen if `Clear-RecycleBin` runs. The cmdlet isn't run. ```yaml Type: SwitchParameter @@ -124,7 +139,10 @@ Accept wildcard characters: False ``` ### CommonParameters -This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216). + +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, +-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, +-WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -132,4 +150,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## NOTES -## RELATED LINKS +## RELATED LINKS \ No newline at end of file