New-SPWebApplicationExtension

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

Синтаксис

New-SPWebApplicationExtension
   [-Identity] <SPWebApplicationPipeBind>
   -Name <String>
   -Zone <SPUrlZone>
   [-Port <UInt32>]
   [-HostHeader <String>]
   [-Certificate <SPServerCertificatePipeBind>]
   [-UseServerNameIndication]
   [-AllowLegacyEncryption]
   [-Path <String>]
   [-Url <String>]
   [-AuthenticationMethod <String>]
   [-AllowAnonymousAccess]
   [-SecureSocketsLayer]
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-SignInRedirectURL <String>]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-SPWebApplicationExtension создает новый экземпляр зоны для веб-приложения. Эта процедура также называется расширением веб-приложения и позволяет настраивать альтернативные разрешения для одного и того же содержимого, имеющегося в веб-приложении.

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

Примеры

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

Get-SPWebApplication http://sitename | New-SPWebApplicationExtension -Name "ExtranetSite" -SecureSocketsLayer -Zone "Extranet" -URL "https://extranet.sitename.com"

В этом примере заданное веб-приложение http://sitename расширяется до зоны экстрасети для использования SSL.

Параметры

-AdditionalClaimProvider

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

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

-AllowAnonymousAccess

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

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

способа проверки подлинности используется протокол Kerberos или NTLM.

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. Этот параметр действителен только при использовании с параметром SecureSocketsLayer.

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

-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

-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

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

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

-Name

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

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

-Path

Указывает физический каталог для нового веб-сайта (в папке виртуальных каталогов). Тип значения: допустимый путь в виде C:\Inutepub\wwwroot\MyWebApplication.

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

-Port

Задает порт приложения. Тип значения: любой допустимый номер порта.

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

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

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

-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

-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-портом, должны иметь один и тот же сертификат сервера.

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

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

Тип должен быть любым из следующих значений: Default, Intranet, Internet, Extranet или Custom

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