Add-SPRoutingRule

Добавляет правило маршрутизации.

Синтаксис

Default (по умолчанию)

Add-SPRoutingRule
    [-RequestManagementSettings] <SPRequestManagementSettingsPipeBind>
    [-Name] <String>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Criteria <SPRequestManagementRuleCriteriaPipeBind[]>]
    [-ExecutionGroup <Int32>]
    [-Expiration <DateTime>]
    [-MachinePool <SPRoutingMachinePoolPipeBind>]
    [<CommonParameters>]

Описание

Командлет Add-SPRoutingRule предназначен для добавления правила маршрутизации для фермы.

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

Примеры

ПРИМЕР

C:\PS>$rm=Get-SPRequestManagementSettings -Identity $web

C:\PS>Get-SPRoutingRule -RequestManagementSettings $rm

C:\PS>$machines=Get-SPRoutingMachineInfo -RequestManagementSettings $rm

C:\PS>Add-SPRoutingMachinePool -RequestManagementSettings $rm -Name <Name of Pool> -MachineTargets $machines

В этом примере показано добавление правила маршрутизации к ферме с использованием переменных $rm и $machines.

Параметры

-AssignmentCollection

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

Свойства параметра

Тип:SPAssignmentCollection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Criteria

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает критерии, с которыми должно совпадать правило.

Свойства параметра

Тип:

SPRequestManagementRuleCriteriaPipeBind[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExecutionGroup

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает группу, в которой будет размещено правило.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Expiration

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает дату и время окончания срока действия правила.

Свойства параметра

Тип:DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MachinePool

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает пул компьютеров, в который будут направляться запросы при совпадении с созданным правилом.

Свойства параметра

Тип:SPRoutingMachinePoolPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает имя правила.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:2
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RequestManagementSettings

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает имя объекта параметров управления запросами для добавления к правилу маршрутизации.

Свойства параметра

Тип:SPRequestManagementSettingsPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.