Grant-SPObjectSecurity

Ссылка

Модуль:: sharepoint-server

Применяется к:: SharePoint Server Subscription Edition

Добавляет в объект SPObjectSecurity нового участника безопасности.

Синтаксис

Grant-SPObjectSecurity
     [-Identity] <SPObjectSecurity>
     [-Principal] <SPClaim>
     [-Rights] <String[]>
     [-AssignmentCollection <SPAssignmentCollection>]
     [-Replace]
     [<CommonParameters>]

Описание

Командлет Grant-SPObjectSecurity добавляет нового участника безопасности (например, пользователя) в объект SPObjectSecurity. Объект SPObjectSecurity — это общий объект, который используется для представления списка управления доступом (ACL) административных объектов SharePoint, в частности приложений-служб.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

------------------ПРИМЕР------------------

$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

В этом примере извлекается объект SPObjectSecurity, соответствующий ACL администратора в приложении-службе профилей пользователей, и добавляется новый субъект-пользователь в этот список управления доступом.

Новый пользователь является администратором приложения-службы $serviceApp.

Параметры

-AssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

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

-Identity

Задает объект SPObjectSecurity, в который добавляется новый участник безопасности. Получить объект SPObjectSecurity можно с помощью командлета Get-SPServiceApplicationSecurity.

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

-Principal

Участник, к которому применяются права.

Тип значения: допустимое название участника, например "Полный доступ".

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

-Replace

Предписывает заменить существующие права для объекта SPObjectSecurity новыми указанными правами. Если этот параметр не задан, новые права добавляются к существующим.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Rights

Права, предоставляемые участнику.

Тип значения: допустимый массив строк, задающий права, которые предоставляются участнику.

Type:	String[]
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition