Set-SPUser

Ссылка

Модуль:: sharepoint-server

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

Настраивает свойства существующего пользователя.

Синтаксис

Set-SPUser
   [-Identity] <SPUserPipeBind>
   [-AddPermissionLevel <String[]>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-ClearPermissions]
   [-Confirm]
   [-DisplayName <String>]
   [-Email <String>]
   [-Group <SPGroupPipeBind>]
   [-IsSiteCollectionAdmin]
   [-PassThru]
   [-RemovePermissionLevel <String[]>]
   [-SyncFromAD]
   [-Web <SPWebPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Командлет Set-SPUser настраивает свойства существующего пользователя.

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

Примеры

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

Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -AddPermissionLevel "Contributor"

В этом примере пользователь (Contoso\jdoe) является участником https://intranet.contoso.comв .

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

Set-SPUser -Identity 'Contoso\jdoe' -Web https://intranet.contoso.com -SyncFromAD

В этом случае в списке сведений о пользователях contoso\jdoe будут обновлены текущие displayName значения атрибутов и mail из учетной записи Active Directory пользователя.

Параметры

-AddPermissionLevel

Определяет уровень разрешений, добавляемых для пользователя.

Значением должен быть один из следующих параметров:

--Способствуют

Может просматривать, добавлять, обновлять и удалять элементы и документы списка.

--Дизайн

Может просматривать, добавлять, обновлять, удалять, утверждать и настраивать документы.

--Полный доступ

Имеет полный доступ ко всем документам.

--Ограниченный доступ

Может просматривать определенные списки, библиотеки документов, элементы списков, папки или документы при предоставлении разрешений.

--Прочитать

Может просматривать страницы и элементы списка и скачивать документы.

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

-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

-ClearPermissions

Удаляет все назначенные пользователю разрешения. Если значения Clear и Add существуют, разрешения сначала очищаются, а затем добавляются новые разрешения.

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

-Confirm

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

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

-DisplayName

Задает новое отображаемое имя пользователя.

Тип значения: допустимое имя.

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

-Email

Задает новый адрес электронной почты пользователя.

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

-Group

Добавляет пользователя в существующую группу на заданном сайте.

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

-Identity

Указывает GUID, имя входа или объект SPUser возвращаемого пользователя.

Тип должен быть GUID существующего пользователя в формате 1234-5678-9876-0987.

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

-IsSiteCollectionAdmin

Указывает, следует ли предоставить пользователю права администратора семейства сайтов.

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

-PassThru

Если параметр не указан, указывает, что этот командлет не имеет выходных данных. Если этот параметр указан, этот параметр указывает, что объект SPUser для этого пользователя должен быть возвращен.

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

-RemovePermissionLevel

Удаляет уровень разрешений для пользователя.

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

-SyncFromAD

Если этот параметр указан, сведения о пользователе синхронизируются с данными из хранилища каталогов пользователей. Этот параметр извлекает displayName только значение и mail из хранилища каталогов. Он поддерживает Active Directory (классическую или проверка подлинности Windows), проверку подлинности на основе форм и SAML. Поставщики FBA и SAML должны поддерживать разрешение из хранилища каталогов, чтобы этот коммутатор работал. Параметр поддерживает только объекты Пользователя SharePoint.

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

-Web

Задает область в виде имени URL или идентификатора GUID. Этот параметр не нужен, если в качестве идентификатора указывается объект SPUser.

Значение должно быть подлинным URL-адресом в форме https://server_nameили GUID в форме 1234-5678-9807.

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

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

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