Get-SPUser

Ссылка

Модуль:: sharepoint-server

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

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

Синтаксис

Get-SPUser
   [[-Identity] <SPUserPipeBind>]
   -Web <SPWebPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Group <SPGroupPipeBind>]
   [-Limit <String>]
   [<CommonParameters>]

Описание

Командлет Get-SPUser возвращает все учетные записи пользователей SharePoint, которые входят в область, заданную с помощью параметра Identity, Web или Group.

Параметр Identity может использовать псевдоним пользователя для возврата точных совпадений.

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

Примеры

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

Get-SPUser -Web 'https://sharepoint.contoso.com' -Group 'Viewers'

В этом примере возвращаются все члены группы зрителей SharePoint на сайте https://sharepoint.contoso.com.

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

Get-SPUser -Identity 'i:0#.w|contoso\jdoe' -Web 'https://sharepoint.contoso.com'

В этом примере возвращается конкретный пользователь, идентифицированный с помощью утверждений Windows на сайте https://sharepoint.contoso.com.

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

Get-SPUser -Identity 'contoso\jdoe' -Web 'https://sharepoint.contoso.com'

В этом примере возвращается конкретный пользователь, идентифицированный с помощью классического проверка подлинности Windows на сайте https://sharepoint.contoso.com.

Параметры

-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

-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

Указывает идентификатор или имя входа возвращаемого пользователя.

Тип должен быть допустимым идентификатором или именем входа, например в формате CONTOSO\jdoe для классической проверки подлинности Windows или i:0#.w| CONTOSO\jdoe' для утверждений Windows.

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

-Limit

Задает максимальное число возвращаемых пользователей. Значение по умолчанию: 500.

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

-Web

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

Тип должен быть допустимым ИДЕНТИФИКАТОРом GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh; допустимое имя веб-сайта SharePoint Foundation (например, MySPSite1); или экземпляр допустимого объекта SPWeb.

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