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


Get-SPUser

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

Синтаксис

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 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

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

-Limit

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

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

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