Поделиться через


Revoke-SPObjectSecurity

Удаляет участника безопасности из объекта SPObjectSecurity.

Синтаксис

RevokeOne

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

RevokeAll

Revoke-SPObjectSecurity
    [-Identity] <SPObjectSecurity>
    [-All]
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

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

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

Примеры

ПРИМЕРЕ

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

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

Параметры

-All

Применимо: SharePoint Server по подписке

Указывает, что из данного объекта SPObjectSecurity удаляются все участники безопасности.

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RevokeAll
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AssignmentCollection

Применимо: SharePoint Server по подписке

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

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

Свойства параметров

Тип:SPAssignmentCollection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: SharePoint Server по подписке

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

Свойства параметров

Тип:SPObjectSecurity
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Principal

Применимо: SharePoint Server по подписке

Участник, для которого удаляются права.

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

Свойства параметров

Тип:SPClaim
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RevokeOne
Position:2
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Rights

Применимо: SharePoint Server по подписке

Права участника, которые требуется отозвать.

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

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RevokeOne
Position:3
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.