Set-SPWebApplication

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

Синтаксис

Set-SPWebApplication
   [-Identity] <SPWebApplicationPipeBind>
   [-DefaultTimeZone <Int32>]
   [-DefaultQuotaTemplate <String>]
   [-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
   [-NotProvisionGlobally]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SPWebApplication
   [-Identity] <SPWebApplicationPipeBind>
   -Zone <SPUrlZone>
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-SignInRedirectURL <String>]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-AuthenticationMethod <String>]
   [-Force]
   [-NotProvisionGlobally]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SPWebApplication
   [-Identity] <SPWebApplicationPipeBind>
   -Zone <SPUrlZone>
   [-SecureSocketsLayer]
   [-HostHeader <String>]
   [-Certificate <SPServerCertificatePipeBind>]
   [-UseServerNameIndication]
   [-AllowLegacyEncryption]
   -Port <Int32>
   [-Url <String>]
   [-NotProvisionGlobally]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SPWebApplication
   [-Identity] <SPWebApplicationPipeBind>
   -SMTPServer <String>
   [-SMTPServerPort <Int32>]
   [-OutgoingEmailAddress <String>]
   [-ReplyToEmailAddress <String>]
   [-SMTPCredentials <PSCredential>]
   [-DisableSMTPEncryption]
   [-Certificate <SPServerCertificatePipeBind>]
   [-NotProvisionGlobally]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

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

Все параметры привязки IIS должны быть изменены при обновлении привязки веб-сайта IIS с помощью командлета Set-SPWebApplication . Сюда входят URL-адрес, параметр уровня безопасных сокетов, номер порта, заголовок узла и сертификат. Если параметр привязки не изменен, он вернется к значению по умолчанию.

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

Примеры

ПРИМЕР 1

$credentials = Get-Credential
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -SMTPServerPort 587 -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $credentials

В этом примере веб-приложение http://servername использует mail.example.com SMTP-сервера, порт SMTP-сервера 587, адрес user@example.comfrom, адрес ответа на адрес replyto@example.comи учетные данные, хранящиеся в объекте $credentials.

ПРИМЕР 2

Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $null

В этом примере веб-приложение http://servername использует mail.example.com SMTP-сервера, порт SMTP-сервера по умолчанию, адрес user@example.comfrom , адрес ответа на адрес replyto@example.comи для анонимного подключения к SMTP-серверу.

Параметры

-AdditionalClaimProvider

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

Type:SPClaimProviderPipeBind[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AllowLegacyEncryption

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

Для этой функции требуется Windows Server 2022 или более поздней версии. Эта функция недоступна при развертывании SharePoint с более ранними версиями Windows Server.

Этот параметр допустим только при использовании с параметром SecureSocketsLayer.

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

-AssignmentCollection

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

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

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

-AuthenticationMethod

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

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

-AuthenticationProvider

Определяет поставщиков проверки подлинности, которые применяются к веб-приложению.

Type:SPAuthenticationProviderPipeBind[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Certificate

Указывает сертификат, который будет использоваться для привязки SSL данного веб-сайта IIS или для проверки подлинности на SMTP-сервере для отправки электронной почты.

При настройке привязки SSL этого веб-сайта IIS этот параметр действителен только при использовании с параметром SecureSocketsLayer. При настройке проверки подлинности SMTP этот параметр действителен только в том случае, если параметр DisableSMTPEncryption не указан.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DefaultQuotaTemplate

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

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

-DefaultTimeZone

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

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

-DisableSMTPEncryption

Указывает, следует ли включить или выключить шифрование SMTP.

Значение по умолчанию — false.

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

-Force

Подавляет сообщения подтверждения, связанные с параметрами веб-приложения.

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

-HostHeader

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

Если привязка заголовка узла не указана, все веб-запросы, отправленные на этот номер порта, будут перенаправлены на этот веб-сайт IIS, если другой веб-сайт IIS не имеет привязку заголовка узла, соответствующую заголовку узла HTTP, отправленному клиентом.

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

-Identity

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

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

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

-NotProvisionGlobally

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

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

-OutgoingEmailAddress

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

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

-Port

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

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

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

-ReplyToEmailAddress

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

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

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

-SecureSocketsLayer

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

Значение по умолчанию — False.

Если этот параметр опущен или задано значение False, это веб-приложение будет использовать HTTP для указанного порта.

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

-ServiceApplicationProxyGroup

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

Type:SPServiceApplicationProxyGroupPipeBind
Aliases:ProxyGroup
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SignInRedirectProvider

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

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

-SignInRedirectURL

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

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

-SMTPCredentials

Указывает учетные данные для проверки подлинности на SMTP-сервере. Задайте значение $null для анонимного подключения к SMTP-серверу. Если этот параметр не указан, существующие параметры проверки подлинности будут сохранены.

Перед указанием Set-SPApplicationCredentialKey учетных данных необходимо использовать командлет PowerShell, чтобы задать идентичный ключ учетных данных приложения на каждом сервере фермы.

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

-SMTPServer

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

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

-SMTPServerPort

Определяет значение порта SMTP.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Url

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

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

-UseServerNameIndication

Указывает, что привязка SSL этого веб-сайта IIS должна использовать указание имени сервера (SNI). Указание имени сервера позволяет нескольким веб-сайтам IIS с уникальными заголовками узлов и уникальными сертификатами сервера совместно использовать один и тот же ПОРТ SSL. Если указание имени сервера не используется, все веб-сайты IIS, использующие один и тот же SSL-порт, должны использовать один и тот же SSL-сертификат.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Zone

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

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

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