Compartir a través de

Add-SPRoutingRule

  • Referencia
Módulo:
SharePointServer
Se aplica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Agrega una regla de enrutamiento.

Syntax

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

Description

El cmdlet Add-SPRoutingRule agrega una regla de enrutamiento a la granja.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

--------------EJEMPLO--------

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

En este ejemplo se agrega una regla de enrutamiento a la granja a través de las variables $rm y $machines.

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Criteria

Especifica los criterios para que se cumpla la regla.

Type:SPRequestManagementRuleCriteriaPipeBind[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ExecutionGroup

Especifica el grupo en que se colocará la regla.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Expiration

Especifica la fecha y la hora de expiración de la regla.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MachinePool

Especifica el grupo de máquinas al que se enrutará una solicitud si se cumple la regla creada.

Type:SPRoutingMachinePoolPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

Especifica el nombre de la regla.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RequestManagementSettings

Especifica el nombre del objeto de configuración de administración de solicitudes que se agregará a la regla de enrutamiento.

Type:SPRequestManagementSettingsPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019