Database.Revoke Database.Revoke Database.Revoke Method

Definition

Revokes a previously granted set of permissions from a grantee or grantees on the database.

Overloads

Revoke(DatabasePermissionSet, String) Revoke(DatabasePermissionSet, String) Revoke(DatabasePermissionSet, String)

Revokes a previously granted set of permissions from a grantee on the database.

Revoke(DatabasePermissionSet, String[]) Revoke(DatabasePermissionSet, String[]) Revoke(DatabasePermissionSet, String[])

Revokes a previously granted set of permissions from a list of grantees on the database.

Revoke(DatabasePermissionSet, String, Boolean, Boolean) Revoke(DatabasePermissionSet, String, Boolean, Boolean) Revoke(DatabasePermissionSet, String, Boolean, Boolean)

Revokes previously granted permissions from a grantee on the database and any other users to whom the grantee has granted the specified set of permissions. The grantee is also given the ability to revoke the specified set of permissions from other users under an assumed role.

Revoke(DatabasePermissionSet, String[], Boolean, Boolean) Revoke(DatabasePermissionSet, String[], Boolean, Boolean) Revoke(DatabasePermissionSet, String[], Boolean, Boolean)

Revokes previously granted permissions from grantees on the database and any other users to whom the grantees have granted the specified set of permissions. The grantees are also given the ability to revoke the specified set of permissions from other users under an assumed role.

Revoke(DatabasePermissionSet, String, Boolean, Boolean, String) Revoke(DatabasePermissionSet, String, Boolean, Boolean, String) Revoke(DatabasePermissionSet, String, Boolean, Boolean, String)

Revokes previously granted permissions from a grantee on the database and any other users to whom the grantee has granted the specified set of permissions. The grantee is also given the ability to revoke the specified set of permissions from other users under an assumed role.

Revoke(DatabasePermissionSet, String[], Boolean, Boolean, String) Revoke(DatabasePermissionSet, String[], Boolean, Boolean, String) Revoke(DatabasePermissionSet, String[], Boolean, Boolean, String)

Revokes previously granted permissions from grantees on the database and any other users to whom the grantees have granted the specified set of permissions. The grantees are also given the ability to revoke the specified set of permissions from other users under an assumed role.

Revoke(DatabasePermissionSet, String) Revoke(DatabasePermissionSet, String) Revoke(DatabasePermissionSet, String)

Revokes a previously granted set of permissions from a grantee on the database.

public:
 void Revoke(Microsoft::SqlServer::Management::Smo::DatabasePermissionSet ^ permission, System::String ^ granteeName);
public void Revoke (Microsoft.SqlServer.Management.Smo.DatabasePermissionSet permission, string granteeName);
Public Sub Revoke (permission As DatabasePermissionSet, granteeName As String)
Parameters
permission
DatabasePermissionSet DatabasePermissionSet DatabasePermissionSet

A DatabasePermissionSet object value that specifies the set of permissions.

granteeName
String String String

A String value that specifies a grantee to be revoked the set of permissions.

Examples

The example shows how to use the Revoke method with server permissions. The method is the same for database permissions.

VB

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")  
$arg = [Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint  

$sps = new-object Microsoft.SqlServer.Management.Smo.ServerPermissionSet([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  
$sps.Add([Microsoft.SqlServer.Management.Smo.ServerPermission]::AlterAnyEndpoint)  
$spis = $srv.EnumServerPermissions("vGrantee", $sps)  
Write-Host "=================Before revoke==========================="  
Foreach ($spi In $spis)  
{  
   Write-Host $spi.Grantee "has" $spi.PermissionType " permission."  
}  
Write-Host " "  
$sps.Remove([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  

Revoke(DatabasePermissionSet, String[]) Revoke(DatabasePermissionSet, String[]) Revoke(DatabasePermissionSet, String[])

Revokes a previously granted set of permissions from a list of grantees on the database.

public:
 void Revoke(Microsoft::SqlServer::Management::Smo::DatabasePermissionSet ^ permission, cli::array <System::String ^> ^ granteeNames);
public void Revoke (Microsoft.SqlServer.Management.Smo.DatabasePermissionSet permission, string[] granteeNames);
Public Sub Revoke (permission As DatabasePermissionSet, granteeNames As String())
Parameters
permission
DatabasePermissionSet DatabasePermissionSet DatabasePermissionSet

A DatabasePermissionSet object value that specifies the set of permissions.

granteeNames
String[]

A String array that specifies a list of grantees to be revoked the set of permissions.

Examples

The example shows how to use the Revoke method with server permissions. The method is the same for database permissions.

VB

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")  
$arg = [Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint  

$sps = new-object Microsoft.SqlServer.Management.Smo.ServerPermissionSet([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  
$sps.Add([Microsoft.SqlServer.Management.Smo.ServerPermission]::AlterAnyEndpoint)  
$spis = $srv.EnumServerPermissions("vGrantee", $sps)  
Write-Host "=================Before revoke==========================="  
Foreach ($spi In $spis)  
{  
   Write-Host $spi.Grantee "has" $spi.PermissionType " permission."  
}  
Write-Host " "  
$sps.Remove([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  

Revoke(DatabasePermissionSet, String, Boolean, Boolean) Revoke(DatabasePermissionSet, String, Boolean, Boolean) Revoke(DatabasePermissionSet, String, Boolean, Boolean)

Revokes previously granted permissions from a grantee on the database and any other users to whom the grantee has granted the specified set of permissions. The grantee is also given the ability to revoke the specified set of permissions from other users under an assumed role.

public:
 void Revoke(Microsoft::SqlServer::Management::Smo::DatabasePermissionSet ^ permission, System::String ^ granteeName, bool revokeGrant, bool cascade);
public void Revoke (Microsoft.SqlServer.Management.Smo.DatabasePermissionSet permission, string granteeName, bool revokeGrant, bool cascade);
Public Sub Revoke (permission As DatabasePermissionSet, granteeName As String, revokeGrant As Boolean, cascade As Boolean)
Parameters
permission
DatabasePermissionSet DatabasePermissionSet DatabasePermissionSet

A DatabasePermissionSet object value that specifies the set of permissions.

granteeName
String String String

A String value that specifies a grantee to be revoked the set of permissions.

revokeGrant
Boolean Boolean Boolean

A Boolean property that specifies whether the grantee is given the ability to revoke the specified set of permissions from other users on the database.

If True, the grantee is given the ability to revoke the specified set of permissions from other users on the database.

If False, the grantee is not given the ability to revoke the specified set of permissions from other users on the database.

cascade
Boolean Boolean Boolean

A Boolean property that specifies whether users, to whom the grantee has granted the specified set of permissions, are also revoked the set of permissions.

If True, the grantee and users to whom the grantee granted the specified set of permission are all revoked the specified set of permissions on the database.

If False, only the grantee is revoked the specified set of permissions.

Examples

The example shows how to use the Revoke method with server permissions. The method is the same for database permissions.

VB

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")  
$arg = [Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint  

$sps = new-object Microsoft.SqlServer.Management.Smo.ServerPermissionSet([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  
$sps.Add([Microsoft.SqlServer.Management.Smo.ServerPermission]::AlterAnyEndpoint)  
$spis = $srv.EnumServerPermissions("vGrantee", $sps)  
Write-Host "=================Before revoke==========================="  
Foreach ($spi In $spis)  
{  
   Write-Host $spi.Grantee "has" $spi.PermissionType " permission."  
}  
Write-Host " "  
$sps.Remove([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  

Revoke(DatabasePermissionSet, String[], Boolean, Boolean) Revoke(DatabasePermissionSet, String[], Boolean, Boolean) Revoke(DatabasePermissionSet, String[], Boolean, Boolean)

Revokes previously granted permissions from grantees on the database and any other users to whom the grantees have granted the specified set of permissions. The grantees are also given the ability to revoke the specified set of permissions from other users under an assumed role.

public:
 void Revoke(Microsoft::SqlServer::Management::Smo::DatabasePermissionSet ^ permission, cli::array <System::String ^> ^ granteeNames, bool revokeGrant, bool cascade);
public void Revoke (Microsoft.SqlServer.Management.Smo.DatabasePermissionSet permission, string[] granteeNames, bool revokeGrant, bool cascade);
Public Sub Revoke (permission As DatabasePermissionSet, granteeNames As String(), revokeGrant As Boolean, cascade As Boolean)
Parameters
permission
DatabasePermissionSet DatabasePermissionSet DatabasePermissionSet

A DatabasePermissionSet object value that specifies the set of permissions.

granteeNames
String[]

A String array that specifies a list of grantees to be revoked access to the set of permissions.

revokeGrant
Boolean Boolean Boolean

A Boolean property that specifies whether the grantee is given the ability to revoke the specified set of permissions from other users on the database.

If True, the grantee is given the ability to revoke the specified set of permissions from other users on the database.

If False, the grantee is not given the ability to revoke the specified set of permissions from other users on the database.

cascade
Boolean Boolean Boolean

A Boolean property that specifies whether users, to whom the grantee has granted the specified set of permissions, are also revoked the set of permissions.

If True, the grantee and users to whom the grantee granted the specified set of permission are all revoked the specified set of permissions on the database.

If False, only the grantee is revoked the specified set of permissions.

Examples

The example shows how to use the [Revoke Method (DatabasePermissionSet, String<xref:Microsoft.SqlServer.Management.Smo.Database.Revoke%2A> method with server permissions. The method is the same for database permissions.

VB

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")  
$arg = [Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint  

$sps = new-object Microsoft.SqlServer.Management.Smo.ServerPermissionSet([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  
$sps.Add([Microsoft.SqlServer.Management.Smo.ServerPermission]::AlterAnyEndpoint)  
$spis = $srv.EnumServerPermissions("vGrantee", $sps)  
Write-Host "=================Before revoke==========================="  
Foreach ($spi In $spis)  
{  
   Write-Host $spi.Grantee "has" $spi.PermissionType " permission."  
}  
Write-Host " "  
$sps.Remove([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  

Revoke(DatabasePermissionSet, String, Boolean, Boolean, String) Revoke(DatabasePermissionSet, String, Boolean, Boolean, String) Revoke(DatabasePermissionSet, String, Boolean, Boolean, String)

Revokes previously granted permissions from a grantee on the database and any other users to whom the grantee has granted the specified set of permissions. The grantee is also given the ability to revoke the specified set of permissions from other users under an assumed role.

public:
 void Revoke(Microsoft::SqlServer::Management::Smo::DatabasePermissionSet ^ permission, System::String ^ granteeName, bool revokeGrant, bool cascade, System::String ^ asRole);
public void Revoke (Microsoft.SqlServer.Management.Smo.DatabasePermissionSet permission, string granteeName, bool revokeGrant, bool cascade, string asRole);
Public Sub Revoke (permission As DatabasePermissionSet, granteeName As String, revokeGrant As Boolean, cascade As Boolean, asRole As String)
Parameters
permission
DatabasePermissionSet DatabasePermissionSet DatabasePermissionSet

A DatabasePermissionSet object value that specifies the set of permissions.

granteeName
String String String

A String value that specifies a grantee to be revoked access to the set of permissions.

revokeGrant
Boolean Boolean Boolean

A Boolean property that specifies whether the grantee is given the ability to revoke the specified set of permissions from other users on the database.

If True, the grantee is given the ability to revoke the specified set of permissions to other users on the database.

If False, the grantee is not given the ability to revoke the specified set of permissions to other users on the database.

cascade
Boolean Boolean Boolean

A Boolean property that specifies whether users to whom the grantee has granted the specified set of permissions are also revoked the set of permissions.

If True, the grantee and users to whom the grantee granted the specified set of permission are all revoked the specified set of permissions on the database.

If False, only the grantee is revoked the specified set of permissions.

asRole
String String String

A String value that specifies the role that the user assumes when that user revokes the specified set of permission from other users on the database. Use this parameter for grantees who are members of more than one role.

Examples

The example shows how to use the Revoke method with server permissions. The method is the same for database permissions.

VB

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")  
$arg = [Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint  

$sps = new-object Microsoft.SqlServer.Management.Smo.ServerPermissionSet([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  
$sps.Add([Microsoft.SqlServer.Management.Smo.ServerPermission]::AlterAnyEndpoint)  
$spis = $srv.EnumServerPermissions("vGrantee", $sps)  
Write-Host "=================Before revoke==========================="  
Foreach ($spi In $spis)  
{  
   Write-Host $spi.Grantee "has" $spi.PermissionType " permission."  
}  
Write-Host " "  
$sps.Remove([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  

Revoke(DatabasePermissionSet, String[], Boolean, Boolean, String) Revoke(DatabasePermissionSet, String[], Boolean, Boolean, String) Revoke(DatabasePermissionSet, String[], Boolean, Boolean, String)

Revokes previously granted permissions from grantees on the database and any other users to whom the grantees have granted the specified set of permissions. The grantees are also given the ability to revoke the specified set of permissions from other users under an assumed role.

public:
 void Revoke(Microsoft::SqlServer::Management::Smo::DatabasePermissionSet ^ permission, cli::array <System::String ^> ^ granteeNames, bool revokeGrant, bool cascade, System::String ^ asRole);
public void Revoke (Microsoft.SqlServer.Management.Smo.DatabasePermissionSet permission, string[] granteeNames, bool revokeGrant, bool cascade, string asRole);
Public Sub Revoke (permission As DatabasePermissionSet, granteeNames As String(), revokeGrant As Boolean, cascade As Boolean, asRole As String)
Parameters
permission
DatabasePermissionSet DatabasePermissionSet DatabasePermissionSet

A DatabasePermissionSet object value that specifies the set of permissions.

granteeNames
String[]

A String array that specifies a list of grantees to be revoked access to the set of permissions.

revokeGrant
Boolean Boolean Boolean

A Boolean property that specifies whether the grantee is given the ability to revoke the specified set of permissions from other users on the database.

If True, the grantee is given the ability to revoke the specified set of permissions to other users on the database.

If False, the grantee is not given the ability to revoke the specified set of permissions to other users on the database.

cascade
Boolean Boolean Boolean

A Boolean property that specifies whether users to whom the grantee has granted the specified set of permissions are also revoked the set of permissions.

If True, the grantee and users to whom the grantee granted the specified set of permission are all revoked the specified set of permissions on the database.

If False, only the grantee is revoked the specified set of permissions.

asRole
String String String

A String value that specifies the role that the user assumes when that user revokes the specified set of permission from other users on the database. Use this parameter for grantees who are members of more than one role.

Examples

The example shows how to use the [Revoke Method (DatabasePermissionSet, String<xref:Microsoft.SqlServer.Management.Smo.Database.Revoke%2A> method with server permissions. The method is the same for database permissions.

VB

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")  
$arg = [Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint  

$sps = new-object Microsoft.SqlServer.Management.Smo.ServerPermissionSet([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  
$sps.Add([Microsoft.SqlServer.Management.Smo.ServerPermission]::AlterAnyEndpoint)  
$spis = $srv.EnumServerPermissions("vGrantee", $sps)  
Write-Host "=================Before revoke==========================="  
Foreach ($spi In $spis)  
{  
   Write-Host $spi.Grantee "has" $spi.PermissionType " permission."  
}  
Write-Host " "  
$sps.Remove([Microsoft.SqlServer.Management.Smo.ServerPermission]::CreateEndpoint)  

Applies to