Condividi tramite


Add-SPThrottlingRule

Aggiunge una nuova regola di limitazione.

Sintassi

Default (impostazione predefinita).

Add-SPThrottlingRule
    [-RequestManagementSettings] <SPRequestManagementSettingsPipeBind>
    [-Name] <String>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Criteria <SPRequestManagementRuleCriteriaPipeBind[]>]
    [-Expiration <DateTime>]
    [-Threshold <Int32>]
    [<CommonParameters>]

Descrizione

Il cmdlet Add-SPThrottlingRule aggiunge una nuova regola di limitazione per la farm usando i parametri Name e RequestManagementSettings.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

ESEMPIO

$web=Get-SPWebApplication -Identity <URL of web application>
$rm=Get-SPRequestManagementSettings -Identity $web
$c=New-SPRequestManagementRuleCriteria -Value http -Property url -MatchType startswith -CaseSensitive $false
Add-SPThrottlingRule -RequestManagementSettings $rm -Name <Rule Name> -Criteria $c -Threshold 4

In questo esempio viene aggiunta una regola di limitazione per un'identità specificata utilizzando le variabili $rm e $c.

Parametri

-AssignmentCollection

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SPAssignmentCollection
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Criteria

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica i criteri della regola da soddisfare.

Proprietà dei parametri

Tipo:

SPRequestManagementRuleCriteriaPipeBind[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Expiration

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica la data e l'ora di scadenza della regola.

Proprietà dei parametri

Tipo:DateTime
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il nome della regola di limitazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RequestManagementSettings

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il nome dell'oggetto impostazioni di gestione delle richieste da aggiungere.

Proprietà dei parametri

Tipo:SPRequestManagementSettingsPipeBind
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Threshold

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica un valore compreso tra 0 e 10 che definisce la soglia massima per la limitazione. Gestione richieste rimuoverà le destinazioni di routing se il relativo stato di integrità diventa superiore a tale valore.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.