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 В этом примере веб-приложение использует сервер SMTP mail.example.com, порт SMTP-сервера 587, адрес с адреса user@example.com, адрес ответа 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 В этом примере веб-приложение использует сервер SMTP mail.example.com, порт SMTP-сервера по умолчанию, адрес с адреса user@example.com, адрес ответа 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

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

Для использования этой функции требуется 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

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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

-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

Указывает новый адрес исходящей электронной почты для сообщений электронной почты, отправленных из этого веб-приложения. Тип должен являться допустимым адресом, например proverka@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

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

Тип должен являться допустимым адресом, например proverka@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 с уникальными заголовками узлов и уникальными сертификатами сервера совместно использовать один ИТ-порт. Если указание имени сервера не используется, все веб-сайты 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

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: 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

-Принудительно

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

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