Compartilhar via


Revoke-SPObjectSecurity

Remove uma entidade de segurança de um objeto SPObjectSecurity.

Syntax

Revoke-SPObjectSecurity
      [-Identity] <SPObjectSecurity>
      [-Principal] <SPClaim>
      [[-Rights] <String[]>]
      [-AssignmentCollection <SPAssignmentCollection>]
      [<CommonParameters>]
Revoke-SPObjectSecurity
      [-Identity] <SPObjectSecurity>
      [-All]
      [-AssignmentCollection <SPAssignmentCollection>]
      [<CommonParameters>]

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O Revoke-SPObjectSecurity cmdlet para remover uma entidade de segurança, como um usuário, de um objeto SPObjectSecurity. Um objeto SPObjectSecurity é um objeto comum usado para representar a ACL (lista de controle de acesso) de objetos administrativos do SharePoint, em particular de aplicativos de serviço.

Para obter permissões e as informações mais atuais sobre Windows PowerShell para Produtos do SharePoint, consulte a documentação online em https://go.microsoft.com/fwlink/p/?LinkId=251831 (https://go.microsoft.com/fwlink/p/?LinkId=251831).

Exemplos

------------------EXEMPLO------------------

$security = Get-SPServiceApplicationSecurity $serviceApp -Admin
Revoke-SPObjectSecurity $security "domain\user"
Set-SPServiceApplicationSecurity $serviceApp -Admin $security

Este exemplo recupera o objeto SPObjectSecurity correspondente à ACL do administrador em um aplicativo de serviço e remove um usuário dessa ACL. O usuário removido é um administrador para o aplicativo de serviço $serviceApp.

Parâmetros

-All

Especifica que todas as entidades de segurança serão removidas do objeto SPObjectSecurity especificado.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-Identity

Especifica o objeto SPObjectSecurity a partir do qual a entidade de segurança é removida. Você pode usar o Get-SPServiceApplicationSecurity cmdlet para obter um objeto SPObjectSecurity .

Type:SPObjectSecurity
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-Principal

Especifica a entidade de segurança da qual os direitos são removidos.

O tipo deve ser um nome válido de entidade de segurança; por exemplo, Controle Total.

Type:SPClaim
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-Rights

Especifica os direitos da entidade de segurança a serem revogados.

O tipo deve ser uma matriz válida de cadeias de caracteres que represente os direitos da entidade de segurança a serem revogados.

Type:String[]
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016