Grant-SPObjectSecurity
Adiciona uma nova entidade de segurança para um objeto SPObjectSecurity.
Sintaxe
Default (Padrão)
Grant-SPObjectSecurity
[-Identity] <SPObjectSecurity>
[-Principal] <SPClaim>
[-Rights] <String[]>
[-AssignmentCollection <SPAssignmentCollection>]
[-Replace]
[<CommonParameters>]
Description
O cmdlet Grant-SPObjectSecurity adiciona uma nova entidade de segurança, como um usuário, a um objeto SPObjectSecurity. Um objeto SPObjectSecurity é um objeto comum que é utilizado para representar a lista de controlo de acesso de segurança (ACL) de objetos administrativos do SharePoint, em particular, aplicações de serviço.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
EXEMPLO
$principal = New-SPClaimsPrincipal "CONTOSO\JaneDoe" -IdentityType WindowsSamAccountName
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'User Profile Service Application'}
$security = Get-SPServiceApplicationSecurity $sa -Admin
Grant-SPObjectSecurity $security $principal "Full Control"
Set-SPServiceApplicationSecurity $sa -Admin $security
Este exemplo obtém o objeto SPObjectSecurity correspondente à ACL de administrador na Aplicação de Serviço de Perfis de Utilizador e adiciona um novo principal de utilizador a essa ACL.
O novo usuário é um administrador do aplicativo de serviço $serviceApp.
Parâmetros
-AssignmentCollection
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.
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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o objeto SPObjectSecurity para o qual a entidade de segurança é adicionada. Você pode usar o cmdlet Get-SPServiceApplicationSecurity 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica a entidade de segurança à qual os direitos se aplicam.
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
(All)
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Replace
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Substitui os direitos existentes no objeto SPObjectSecurity pelos novos direitos especificados. Caso esse parâmetro não seja especificado, os novos direitos serão adicionados aos direitos existentes.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Rights
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica os direitos concedidos à entidade de segurança.
O tipo deve ser uma matriz válida de cadeias de caracteres que represente os direitos concedidos à entidade de segurança.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | True |
| 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.