New-SPRequestManagementRuleCriteria

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Crea i criteri della regola da soddisfare.

Sintassi

New-SPRequestManagementRuleCriteria
   [-Value] <String>
   [-CustomHeader] <String>
   [-CaseSensitive]
   [[-MatchType] <SPRequestManagementRuleMatchType>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]
New-SPRequestManagementRuleCriteria
   [-Value] <String>
   [-Property] <SPRequestManagementRulePropertyType>
   [-CaseSensitive]
   [[-MatchType] <SPRequestManagementRuleMatchType>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Usare il New-SPRequestManagementRuleCriteria cmdlet per creare criteri per la corrispondenza della regola.

Esempio

------------------ESEMPIO-----------------------

New-SPRequestManagementRuleCriteria -Property Host -Value Client01 -MatchType Equals

In questo esempio viene creata una nuova regola corrispondente all'host 'Client01'.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

-CaseSensitive

Specifica se per la corrispondenza deve essere applicata o meno la distinzione tra maiuscole e minuscole.

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

-CustomHeader

Specifica l'intestazione personalizzata per la regola.

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

-MatchType

Definisce gli operatori per la corrispondenza.

I valori validi sono seguenti:

--Equals

--Regex

--Startswith

--EndsWith

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

-Property

Specifica un'intestazione di un valore da soddisfare.

I valori validi sono seguenti:

--Url

--Urlreferrer

--Useragent

--Host

--IP

--HttpMethod

--Soapaction

--CustomHeader

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

-Value

Specifica un valore della regola da soddisfare.

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