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


New-SPUser

Добавляет существующего пользователя на сайт SharePoint с назначенными разрешениями.

Синтаксис

New-SPUser
   [-UserAlias] <String>
   -Web <SPWebPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DisplayName <String>]
   [-Email <String>]
   [-Group <SPGroupPipeBind>]
   [-PermissionLevel <String[]>]
   [-SiteCollectionAdmin]
   [-WhatIf]
   [<CommonParameters>]

Описание

Командлет New-SPUser добавляет существующего пользователя на веб-сайт SharePoint с указанными разрешениями. Этот пользователь имеет указанные разрешения на всех дочерних сайтах, которые наследуют разрешения. Учетная запись пользователя уже должна существовать в каталоге пользователя.

Если ваша среда находится в режиме Active Directory, пользователь уже должен существовать в доменные службы Active Directory (AD DS) и требуется только параметр UserAlias; все остальные поля извлекаются из AD DS. Если задан только псевдоним и ферма находится в режиме создания учетной записи Active Directory, также требуется параметр Email.

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

Примеры

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

New-SPUser -UserAlias 'Contoso\Jdow'-DisplayName 'Jane Dow' -Web https://contoso.com

В этом примере в домен Contoso добавляется новый пользователь с именем Jane Dow.

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

Get-SPWeb https://sitename | New-SPUser -UserAlias Contoso\Jdow

В этом примере contoso\Jdow добавляется во все веб-сайты в семействе https://sitename веб-сайтов. Поскольку в данном семействе сайтов наследуются разрешения пользователей, настроить необходимо только веб-сайт верхнего уровня.

Параметры

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisplayName

Указывает строку, содержащую отображаемое имя пользователя.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Email

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

Тип должен быть допустимым адресом электронной почты в формате someone@contoso.com.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Group

Задает группу пользователей, в которую будет входить новый пользователь.

Type:SPGroupPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-PermissionLevel

Добавляет пользователя к уровню разрешения.

Типом должен быть допустимый уровень разрешений для веб-приложения, например, Full Control, Read, Contribute или All.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SiteCollectionAdmin

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UserAlias

Указывает псевдоним пользователя из доменные службы Active Directory (AD DS).

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Web

Указывает URL-адрес или идентификатор GUID веб-сайта, на котором необходимо создать пользователя.

Типом должен быть действительный URL-адрес в виде http://имя_сервера или допустимый идентификатор GUID в виде 1234-5678-9876-0987.

Type:SPWebPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019