Revoke-SPObjectSecurity
Remove uma entidade de segurança de um objeto SPObjectSecurity.
Sintaxe
RevokeOne
Revoke-SPObjectSecurity
[-Identity] <SPObjectSecurity>
[-Principal] <SPClaim>
[[-Rights] <String[]>]
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
RevokeAll
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 um principal de segurança, como um utilizador, 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 recentes sobre Windows PowerShell para Produtos 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 obtém o objeto SPObjectSecurity correspondente à ACL de administrador numa aplicação de serviço e remove um utilizador dessa ACL. O usuário removido é um administrador para o aplicativo de serviço $serviceApp.
Parâmetros
-All
Aplicável: SharePoint Server 2013, SharePoint Server 2016
Especifica que todas as entidades de segurança serão removidas do objeto SPObjectSecurity especificado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RevokeAll
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AssignmentCollection
Aplicável: SharePoint Server 2013, SharePoint Server 2016
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.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: SharePoint Server 2013, SharePoint Server 2016
Especifica o objeto SPObjectSecurity a partir do qual a entidade de segurança é removida.
Pode utilizar o Get-SPServiceApplicationSecurity cmdlet para obter um objeto SPObjectSecurity.
Propriedades do parâmetro
| Tipo: | SPObjectSecurity |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Principal
Aplicável: SharePoint Server 2013, SharePoint Server 2016
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.
Propriedades do parâmetro
| Tipo: | SPClaim |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RevokeOne
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Rights
Aplicável: SharePoint Server 2013, SharePoint Server 2016
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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RevokeOne
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.