New-SPWebApplication

Ссылка

Модуль:: sharepoint-server

Применяется к:: SharePoint Server Subscription Edition

Создает новое веб-приложение в локальной ферме.

Синтаксис

New-SPWebApplication
   -Name <String>
   -ApplicationPool <String>
   [-ApplicationPoolAccount <SPProcessAccountPipeBind>]
   [-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
   [-SecureSocketsLayer]
   [-HostHeader <String>]
   [-Certificate <SPServerCertificatePipeBind>]
   [-UseServerNameIndication]
   [-AllowLegacyEncryption]
   [-Port <UInt32>]
   [-AllowAnonymousAccess]
   [-Path <String>]
   [-Url <String>]
   [-AuthenticationMethod <String>]
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-SignInRedirectURL <String>]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
   [-DatabaseCredentials <PSCredential>]
   [-DatabaseServer <String>]
   [-DatabaseName <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Создает новое веб-приложение, заданное параметром Name. Пользователь, заданный параметром DatabaseCredentials, должен быть членом предопределенной роли сервера dbcreator на сервере базы данных.

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

Примеры

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

New-SPWebApplication -Name "Contoso Internet Site" -Port 80 -HostHeader sharepoint.contoso.com -URL "http://www.contoso.com" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")

В этом примере создается веб-приложение с помощью внутреннего заголовка узла sharepoint.contoso.com и общедоступного http://www.contoso.comURL-адреса .

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

New-SPWebApplication -Name "Contoso Internet Site" -Port 443 -SecureSocketsLayer -HostHeader sharepoint.contoso.com -URL "https://www.contoso.com:443" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")

В этом примере создается новое веб-приложение с поддержкой SSL, используя внутренний заголовок узла sharepoint.contoso.com и общедоступный URL-адрес https://www.contoso.com.

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

$ap = New-SPAuthenticationProvider
New-SPWebApplication -Name "Contoso Internet Site" -URL "https://www.contoso.com"  -Port 443 
-ApplicationPool "ContosoAppPool" 
-ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa") 
-AuthenticationProvider $ap -SecureSocketsLayer

Создает веб-приложение утверждений Windows по URL-адресу https://www.contoso.com с помощью учетной записи домена domain\wa.

Параметры

-AdditionalClaimProvider

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

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

-AllowAnonymousAccess

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ApplicationPool

Указывает имя используемого пула приложений; Например, SharePoint — 1213. Если пул приложений с указанным именем не существует, необходимо указать параметр ApplicationPoolAccount и создать новый пул приложений. Если значение не указано, будет использоваться пул приложений по умолчанию.

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

-ApplicationPoolAccount

Задает учетную запись пользователя для запуска данного пула приложений. Get-SPIisWebServicApplicationPool Используйте командлет для использования системной учетной записи.

Type:	SPProcessAccountPipeBind
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AuthenticationMethod

способа проверки подлинности используется протокол Kerberos или NTLM. Если значение этого параметра не указано, используется значение по умолчанию — NTLM.

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

-AuthenticationProvider

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

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

-Certificate

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

Type:	SPServerCertificatePipeBind
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseCredentials

Задает объект Windows PowerShell Credential для учетной записи пользователя базы данных.

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

-DatabaseName

Задает имя начальной базы данных контента для нового веб-приложения.

Тип значения: допустимое имя базы данных, например ContentDB1. Если значение не указано, автоматически создается значение в формате WSS_Content_<GUID> .

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

-DatabaseServer

Задает имя сервера базы данных. Тип значения: допустимое имя сервера базы данных в виде SQL1 (при использовании именованных экземпляров — в виде "сервер\сервер"). Если значение этого параметра не указано, используется экземпляр сервера SQL Server по умолчанию.

Type:	String
Position:	Named
Default value:	None
Required:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Name

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

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

-Path

Указывает физический каталог для нового веб-приложения в папке виртуальных каталогов. Тип значения: допустимый путь в виде C:\Inutepub\wwwroot\MyWebApplication. Если значение не указано, применяется значение %wwwroot%\wss\VirtualDirectories\<portnumber> .

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

-Port

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

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

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ServiceApplicationProxyGroup

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

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

-SignInRedirectProvider

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

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

-SignInRedirectURL

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

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

-Url

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

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

-UserSettingsProvider

Предоставляет доступ к внешнему поставщику параметров пользователя.

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

-UseServerNameIndication

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition