Remove-DSDeletedUser

Synopsis

Permanently delete a deleted user

Syntax

__AllParameterSets

Remove-DSDeletedUser -ID <guid> [-WhatIf] [-Confirm] [<CommonParameters>]

Description

Permanently delete a user that has already been marked as deleted. This action cannot be undone.

Examples

Example 1

PS C:\> Remove-DSDeletedUser -ID '3c5d7e8f-9a1b-4c2d-8e3f-4a5b6c7d8e9f'

Permanently delete a user that was previously soft-deleted.

Example 2

PS C:\> Remove-DSUser -UserID $userId
PS C:\> Remove-DSDeletedUser -ID $userId

Permanently delete a user (cannot be undone). Must soft-delete first, then hard-delete.

Example 3

PS C:\> $deletedUser = Get-DSDeletedUser | Where Name -EQ 'johndoe'
PS C:\> Remove-DSDeletedUser -ID $deletedUser.ID

Get a deleted user by username and permanently delete it.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ID

ID of the deleted user to permanently remove.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Notes

For more information, type "Get-Help Remove-DSDeletedUser -detailed". For technical information, type "Get-Help Remove-DSDeletedUser -full".