| Author | Doug Meyers (@dgmyrs) |
| Availability | Windows, Linux, macOS |
Want to see the source code for this command? Check out Remove-DbaDbUser on GitHub.
Want to see the Bill Of Health for this command? Check out Remove-DbaDbUser.
Drop database user
If user is the owner of a schema with the same name and if if the schema does not have any underlying objects the schema will be dropped. If user owns more than one schema, the owner of the schemas that does not have the same name as the user, will be changed to 'dbo'. If schemas have underlying objects, you must specify the -Force parameter so the user can be dropped.
Remove-DbaDbUser
[-SqlInstance] <DbaInstanceParameter[]>
[-SqlCredential <PSCredential>]
[-Database <Object[]>]
[-ExcludeDatabase <Object[]>] -User <Object[]>
[-Force]
[-EnableException]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-DbaDbUser -InputObject <User[]>
[-Force]
[-EnableException]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
PS C:\> Remove-DbaDbUser -SqlInstance sqlserver2014 -User user1
Drops user1 from all databases it exists in on server 'sqlserver2014'.
PS C:\> Remove-DbaDbUser -SqlInstance sqlserver2014 -Database database1 -User user1
Drops user1 from the database1 database on server 'sqlserver2014'.
PS C:\> Remove-DbaDbUser -SqlInstance sqlserver2014 -ExcludeDatabase model -User user1
Drops user1 from all databases it exists in on server 'sqlserver2014' except for the model database.
PS C:\> Get-DbaDbUser sqlserver2014 | Where-Object Name -In "user1" | Remove-DbaDbUser
Drops user1 from all databases it exists in on server 'sqlserver2014'.
The target SQL Server instance or instances.
| Alias | |
| Required | True |
| Pipeline | true (ByValue) |
| Default Value |
Specifies the list of users to remove.
| Alias | |
| Required | True |
| Pipeline | false |
| Default Value |
Support piping from Get-DbaDbUser.
| Alias | |
| Required | True |
| Pipeline | true (ByValue) |
| Default Value |
Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential).
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported.
For MFA support, please use Connect-DbaInstance..
| Alias | |
| Required | False |
| Pipeline | false |
| Default Value |
Specifies the database(s) to process. Options for this list are auto-populated from the server. If unspecified, all databases will be processed.
| Alias | |
| Required | False |
| Pipeline | false |
| Default Value |
Specifies the database(s) to exclude from processing. Options for this list are auto-populated from the server.
| Alias | |
| Required | False |
| Pipeline | false |
| Default Value |
If enabled this will force the change of the owner to 'dbo' for any schema which owner is the User.
| Alias | |
| Required | False |
| Pipeline | false |
| Default Value | False |
By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables advanced scripting.
Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own try/catch.
| Alias | |
| Required | False |
| Pipeline | false |
| Default Value | False |
Shows what would happen if the command were to run. No actions are actually performed.
| Alias | wi |
| Required | False |
| Pipeline | false |
| Default Value |
If this switch is enabled, you will be prompted for confirmation before executing any operations that change state.
| Alias | cf |
| Required | False |
| Pipeline | false |
| Default Value |