Set-SPUser
Настраивает свойства существующего пользователя.
Синтаксис
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 |
Задает новый адрес электронной почты пользователя.
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 |