Set-SPWebApplication

Настраивает указанное веб-приложение.

Синтаксис

UpdateMailSettings

Set-SPWebApplication
    [-Identity] <SPWebApplicationPipeBind>
    -SMTPServer <String>
    [-OutgoingEmailAddress <String>]
    [-ReplyToEmailAddress <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Force]
    [-WhatIf]
    [-DisableSMTPEncryption]
    [-NotProvisionGlobally]
    [-SMTPServerPort <Int32>]
    [<CommonParameters>]

UpdateClaimSettings

Set-SPWebApplication
    [-Identity] <SPWebApplicationPipeBind>
    -Zone <SPUrlZone>
    [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-AuthenticationMethod <String>]
    [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
    [-Confirm]
    [-Force]
    [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
    [-SignInRedirectURL <String>]
    [-WhatIf]
    [-NotProvisionGlobally]
    [<CommonParameters>]

UpdateGeneralSettings

Set-SPWebApplication
    [-Identity] <SPWebApplicationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DefaultQuotaTemplate <String>]
    [-DefaultTimeZone <Int32>]
    [-Force]
    [-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
    [-WhatIf]
    [-NotProvisionGlobally]
    [<CommonParameters>]

Описание

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

Командлет Set-SPWebApplication настраивает веб-приложение, указанное параметром Identity. Для всех параметров, относящихся к зоне (набор параметров Zone), необходимо предоставить настраиваемую зону. Такая зона должна существовать на данный момент.

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

Примеры

ПРИМЕР

$ap = New-SPAuthenticationProvider -AllowAnonymous
Set-SPWebApplication http://somesite -Zone "Extranet" -HostHeader "http://www.contoso.com" -AuthenticationProvider $ap

В этом примере задается URL-адрес HostHeader для зоны экстрасети данного веб-приложения как http://www.contoso.com и включает анонимный доступ.

Параметры

-AdditionalClaimProvider

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Добавляет заданный поставщик утверждений в определенное веб-приложение.

Свойства параметра

Тип:

SPClaimProviderPipeBind[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateClaimSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AssignmentCollection

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

При использовании параметра Global все объекты содержатся в глобальном хранилище. Если объекты не используются сразу или удаляются с помощью команды Stop-SPAssignment, может возникнуть нехватка памяти.

Свойства параметра

Тип:SPAssignmentCollection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AuthenticationMethod

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Используется для настройки для веб-приложения классической проверки подлинности Windows. Допустимые значения: NTLM или Kerberos.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateClaimSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AuthenticationProvider

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает поставщик (или поставщики) проверки подлинности для веб-приложения.

Свойства параметра

Тип:

SPAuthenticationProviderPipeBind[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateClaimSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultQuotaTemplate

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateGeneralSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultTimeZone

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateGeneralSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisableSMTPEncryption

Применимо: SharePoint Server 2016, SharePoint Server 2019

{{Fill DisableSMTPEncryption Description}}

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateMailSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Блокирует сообщения о подтверждении, отображаемые в настройках веб-приложения.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает имя или URL-адрес веб-приложения.

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

Свойства параметра

Тип:SPWebApplicationPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-NotProvisionGlobally

Применимо: SharePoint Server 2016, SharePoint Server 2019

{{Fill NotProvisionGlobally Description}}

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OutgoingEmailAddress

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает новый адрес исходящей электронной почты для сообщений, отправляемых с помощью данного веб-приложения. Тип должен быть допустимым адресом; например, someone@example.com.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateMailSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ReplyToEmailAddress

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Настраивает обратный адрес электронной почты.

Тип должен быть допустимым адресом; например, someone@example.com.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateMailSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ServiceApplicationProxyGroup

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает настраиваемую группу прокси приложения-службы для веб-приложения. Веб-приложение будет подключаться к приложениям-службам с использованием прокси из этой группы. Если этот параметр не указан, используется группа прокси-серверов фермы по умолчанию.

Свойства параметра

Тип:SPServiceApplicationProxyGroupPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ProxyGroup

Наборы параметров

UpdateGeneralSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SignInRedirectProvider

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает в качестве URL-адреса перенаправления после входа URL-адрес, определенный в указанном поставщике проверки подлинности.

Свойства параметра

Тип:SPTrustedIdentityTokenIssuerPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateClaimSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SignInRedirectURL

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает URL-адрес перенаправления после входа для веб-приложения.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateClaimSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SMTPServer

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateMailSettings
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SMTPServerPort

Применимо: SharePoint Server 2016, SharePoint Server 2019

{{Fill SMTPServerPort Description}}

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateMailSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Zone

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

При настройке параметров для конкретной зоны необходимо указать настраиваемую зону. Эта зона уже должна существовать.

Допустимые типы: По умолчанию, Интрасеть, Интернет, Экстрасеть или Другое.

Свойства параметра

Тип:SPUrlZone
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateClaimSettings
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.