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 |
| 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 |
-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.
| 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 |
-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 |
-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 |
-Identity
Указывает расширяемое веб-приложение.
| Type: | SPWebApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
Указывает имя нового веб-сайта IIS в веб-приложении.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
| 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 |
-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 |
-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 |
-Zone
Указывает одну из пяти зон, с которой будет связан внутренний URL-адрес нового расширения. Эта зона уже не может использоваться.
Тип должен иметь одно из следующих значений: Default, Intranet, Internet, Extranet или Custom
| Type: | SPUrlZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |