Set-SPProfileServiceApplication

Ссылка

Модуль:: SharePointServer

Применяется к:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает свойства приложения-службы профилей пользователей.

Синтаксис

Set-SPProfileServiceApplication
   [-Identity] <SPServiceApplicationPipeBind>
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-GetNonImportedObjects <Boolean>]
   [-MySiteHostLocation <SPSitePipeBind>]
   [-ProfileDBCredentials <PSCredential>]
   [-ProfileSyncDBCredentials <PSCredential>]
   [-ProfileSyncDBFailoverServer <String>]
   [-PurgeNonImportedObjects <Boolean>]
   [-SocialDBCredentials <PSCredential>]
   [-SocialDBFailoverServer <String>]
   [-Name <String>]
   [-UseOnlyPreferredDomainControllers <Boolean>]
   [-WhatIf]
   [-ProfileDBFailoverServer <String>]
   [<CommonParameters>]

Set-SPProfileServiceApplication
   [-Identity] <SPServiceApplicationPipeBind>
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-GetNonImportedObjects <Boolean>]
   -MySiteHostLocation <SPSitePipeBind>
   [-MySiteManagedPath <SPPrefixPipeBind>]
   [-ProfileDBCredentials <PSCredential>]
   [-ProfileSyncDBCredentials <PSCredential>]
   [-ProfileSyncDBFailoverServer <String>]
   [-PurgeNonImportedObjects <Boolean>]
   [-SiteNamingConflictResolution <String>]
   [-SocialDBCredentials <PSCredential>]
   [-SocialDBFailoverServer <String>]
   [-Name <String>]
   [-UseOnlyPreferredDomainControllers <Boolean>]
   [-WhatIf]
   [-ProfileDBFailoverServer <String>]
   [<CommonParameters>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

Командлет Set-SPProfileServiceApplication задает свойства приложения-службы профилей пользователей.

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

Примеры

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

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'User Profile Service Application'}
Set-SPProfileServiceApplication -Identity $sa -PurgeNonImportedObjects:$true

В этом примере удаляются объекты из базы данных Профиля, которые не находятся в области импорта профиля пользователя.

Параметры

-ApplicationPool

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

Типом должен быть действительный идентификатор GUID в виде 12345678-90ab-cdef-1234-567890bcdefgh, действительное имя пула приложений (например, AppPoolName1) или экземпляр действительного объекта IISWebServiceApplicationPool.

Type:	SPIisWebServiceApplicationPoolPipeBind
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

-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

-GetNonImportedObjects

Определяет, сообщать ли пользователям, которые поступили не из конвейера импорта и будут помечены для удаления. Список удаляемых пользователей показывается в консольном окне.

Type:	Boolean
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

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

Типом должен быть действительный идентификатор GUID в виде 12345678-90ab-cdef-1234-567890bcdefgh, действительное имя приложения-службы настройки подписки (например, SubscriptionSettingsApp1) или экземпляр действительного объекта SPServiceApplication.

Type:	SPServiceApplicationPipeBind
Position:	1
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

-MySiteHostLocation

Задает семейство сайтов, в котором будет выполнена подготовка сайта "Мой сайт".

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

Type:	SPSitePipeBind
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

-MySiteManagedPath

Указывает управляемый путь к личным сайтам.

Тип должен быть допустимым URL-адресом в форме https://server_name.

Type:	SPPrefixPipeBind
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

-Name

Указывает отображаемое имя нового приложения службы профилей пользователей. Используемое имя должно быть уникальным именем приложения службы профилей пользователей в этой ферме. Это имя может содержать не более 128 знаков.

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

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

-ProfileDBCredentials

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

Типом должен быть действительный объект PSCredential.

Type:	PSCredential
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

-ProfileDBFailoverServer

Определяет имя резервного сервера SQL для базы данных профилей. Оно используется с целью создания строки подключения для базы данных профилей.

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

-ProfileSyncDBCredentials

Задает набор учетных данных (имя пользователя и пароль), которые будут использоваться для подключения к базе данных синхронизации профилей Profile Sync, указанной с помощью параметра ProfileSyncDBName.

Тип должен быть допустимым объектом PSCredential.

Type:	PSCredential
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

-ProfileSyncDBFailoverServer

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

-PurgeNonImportedObjects

Определяет, отмечать ли неимпортированных пользователей в хранилище профилей для удаления, а затем сообщать ли пользователям, которые поступили не из конвейера импорта и которые будут отмечены для удаления. Список удаляемых пользователей показывается в консольном окне.

Type:	Boolean
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

-SiteNamingConflictResolution

Задает формат именования личных сайтов.

Допустимы следующие целые значения:

1 — имена семейств личных сайтов создаются на основе имен пользователей без какого-либо разрешения конфликтов. Пример: https://portal_site/location/username/

2 — имена семейств личных сайтов создаются на основе имен пользователей с разрешением конфликтов с помощью имен доменов. Пример: .../имя_пользователя/ или .../домен_имя_пользователя/

3 Личные семейства веб-сайтов должны всегда именоваться по имени домена и пользователя, чтобы избежать конфликтов. Пример: https://portal_site/location/domain_username/

Значение по умолчанию — 1 (не разрешать конфликты).

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

-SocialDBCredentials

Набор учетных данных (в том числе имя пользователя и пароль), используемых для подключения к базе данных Social, создаваемой командлетом.