Server.Revoke Server.Revoke Server.Revoke Method

Definition

Revokes a previously granted set of permissions from a grantee or grantees on the instance of SQL Server.

Overloads

Revoke(ServerPermissionSet, String[]) Revoke(ServerPermissionSet, String[]) Revoke(ServerPermissionSet, String[])

Revokes a previously granted set of permissions from a list of grantees on the instance of SQL Server.

Revoke(ServerPermissionSet, String, Boolean, Boolean) Revoke(ServerPermissionSet, String, Boolean, Boolean) Revoke(ServerPermissionSet, String, Boolean, Boolean)

Revokes previously granted permissions from a grantee on the instance of SQL Server 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(ServerPermissionSet, String[], Boolean, Boolean) Revoke(ServerPermissionSet, String[], Boolean, Boolean) Revoke(ServerPermissionSet, String[], Boolean, Boolean)

Revokes previously granted permissions from grantees on the instance of SQL Server 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(ServerPermissionSet, String, Boolean, Boolean, String) Revoke(ServerPermissionSet, String, Boolean, Boolean, String) Revoke(ServerPermissionSet, String, Boolean, Boolean, String)

Revokes previously granted permissions from a grantee on the instance of SQL Server 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(ServerPermissionSet, String[], Boolean, Boolean, String) Revoke(ServerPermissionSet, String[], Boolean, Boolean, String) Revoke(ServerPermissionSet, String[], Boolean, Boolean, String)

Revokes previously granted permissions from grantees on the instance of SQL Server 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(ServerPermissionSet, String) Revoke(ServerPermissionSet, String) Revoke(ServerPermissionSet, String)

Revokes a previously granted set of permissions from a list of grantees on the instance of SQL Server.

Remarks

The Revoke method has several overloads that give you a choice of whether to revoke one or more permissions from a single grantee or from several grantees. It lets you specify whether the grantee has permission to revoke the permissions from others, and what role the grantee assumes when taking this action. This method also lets you revoke any permissions that the grantee might have granted to other users.

Revoke(ServerPermissionSet, String[]) Revoke(ServerPermissionSet, String[]) Revoke(ServerPermissionSet, String[])

Revokes a previously granted set of permissions from a list of grantees on the instance of SQL Server.

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

A ServerPermissionSet object that specifies the permission.

granteeNames
String[]

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

Examples

Visual Basic

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(ServerPermissionSet, String, Boolean, Boolean) Revoke(ServerPermissionSet, String, Boolean, Boolean) Revoke(ServerPermissionSet, String, Boolean, Boolean)

Revokes previously granted permissions from a grantee on the instance of SQL Server 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::ServerPermissionSet ^ permission, System::String ^ granteeName, bool revokeGrant, bool cascade);
public void Revoke (Microsoft.SqlServer.Management.Smo.ServerPermissionSet permission, string granteeName, bool revokeGrant, bool cascade);
Public Sub Revoke (permission As ServerPermissionSet, granteeName As String, revokeGrant As Boolean, cascade As Boolean)
Parameters
permission
ServerPermissionSet ServerPermissionSet ServerPermissionSet

A ServerPermissionSet object that specifies the permission.

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 instance of SQL Server.

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

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

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 instance of SQL Server.

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

Examples

Visual Basic

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(ServerPermissionSet, String[], Boolean, Boolean) Revoke(ServerPermissionSet, String[], Boolean, Boolean) Revoke(ServerPermissionSet, String[], Boolean, Boolean)

Revokes previously granted permissions from grantees on the instance of SQL Server 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::ServerPermissionSet ^ permission, cli::array <System::String ^> ^ granteeNames, bool revokeGrant, bool cascade);
public void Revoke (Microsoft.SqlServer.Management.Smo.ServerPermissionSet permission, string[] granteeNames, bool revokeGrant, bool cascade);
Public Sub Revoke (permission As ServerPermissionSet, granteeNames As String(), revokeGrant As Boolean, cascade As Boolean)
Parameters
permission
ServerPermissionSet ServerPermissionSet ServerPermissionSet

A ServerPermissionSet object that specifies the permission.

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 instance of SQL Server.

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

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

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 instance of SQL Server.

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

Examples

Visual Basic

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(ServerPermissionSet, String, Boolean, Boolean, String) Revoke(ServerPermissionSet, String, Boolean, Boolean, String) Revoke(ServerPermissionSet, String, Boolean, Boolean, String)

Revokes previously granted permissions from a grantee on the instance of SQL Server 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::ServerPermissionSet ^ permission, System::String ^ granteeName, bool revokeGrant, bool cascade, System::String ^ asRole);
public void Revoke (Microsoft.SqlServer.Management.Smo.ServerPermissionSet permission, string granteeName, bool revokeGrant, bool cascade, string asRole);
Public Sub Revoke (permission As ServerPermissionSet, granteeName As String, revokeGrant As Boolean, cascade As Boolean, asRole As String)
Parameters
permission
ServerPermissionSet ServerPermissionSet ServerPermissionSet

A ServerPermissionSet object that specifies the permission.

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 instance of SQL Server.

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

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

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 instance of SQL Server.

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 revoking the specified set of permission from other users on the instance of SQL Server. Use this parameter for grantees who are members of more than one role.

Examples

Visual Basic

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(ServerPermissionSet, String[], Boolean, Boolean, String) Revoke(ServerPermissionSet, String[], Boolean, Boolean, String) Revoke(ServerPermissionSet, String[], Boolean, Boolean, String)

Revokes previously granted permissions from grantees on the instance of SQL Server 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::ServerPermissionSet ^ permission, cli::array <System::String ^> ^ granteeNames, bool revokeGrant, bool cascade, System::String ^ asRole);
public void Revoke (Microsoft.SqlServer.Management.Smo.ServerPermissionSet permission, string[] granteeNames, bool revokeGrant, bool cascade, string asRole);
Public Sub Revoke (permission As ServerPermissionSet, granteeNames As String(), revokeGrant As Boolean, cascade As Boolean, asRole As String)
Parameters
permission
ServerPermissionSet ServerPermissionSet ServerPermissionSet

A ServerPermissionSet object that specifies the permission.

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 instance of SQL Server.

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

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

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 instance of SQL Server.

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 revoking the specified set of permission from other users on the instance of SQL Server. Use this parameter for grantees who are members of more than one role.

Examples

Visual Basic

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(ServerPermissionSet, String) Revoke(ServerPermissionSet, String) Revoke(ServerPermissionSet, String)

Revokes a previously granted set of permissions from a list of grantees on the instance of SQL Server.

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

A ServerPermissionSet object that specifies the permission.

granteeName
String String String

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

Examples

Visual Basic

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