Поделиться через


Set-SPServiceHostConfig

Настраивает один или несколько общих параметров для всех веб-служб.

Синтаксис

Set-SPServiceHostConfig
   [-Identity] <SPIisWebServiceSettings>
   [-HttpPort <Int32>]
   [-HttpsPort <Int32>]
   [-NetTcpPort <Int32>]
   [-ImportSslCertificate <X509Certificate2>]
   [-AllowLegacyEncryption]
   [-NoWait]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SPServiceHostConfig
   [-Identity] <SPIisWebServiceSettings>
   [-HttpPort <Int32>]
   [-HttpsPort <Int32>]
   [-NetTcpPort <Int32>]
   -SslCertificateThumbprint <String>
   [-SslCertificateStoreName <String>]
   [-AllowLegacyEncryption]
   [-NoWait]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SPServiceHostConfig
   [-Identity] <SPIisWebServiceSettings>
   -SslCertificateThumbprint <String>
   [-SslCertificateStoreName <String>]
   [-RunInProcess]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Командлет Set- SPServiceHostConfig настраивает один или несколько общих параметров для всех веб-служб.

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

Примеры

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

Set-SPServiceHostConfig -Port 12345

В этом примере задается HTTP-порт для веб-служб.

Параметры

-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

-Confirm

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

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

-HttpPort

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

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

-HttpsPort

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

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

-Identity

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

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

-ImportSslCertificate

Сертификат SSL для использования с защищенными протоколами.

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

-NetTcpPort

Задает TCP-порт для веб-службы.

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

-NoWait

Дополнительные сведения см. на сайте TechNet.

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

-RunInProcess

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

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

-SslCertificateStoreName

Указывает имя хранилища сертификатов, содержащего SSL-сертификат, извлекаемого для защищенных протоколов.

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

-SslCertificateThumbprint

Отпечаток сертификата SSL для безопасных протоколов.

Type:String
Position:Named
Default value:None
Required:True
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