Condividi tramite


Add-SPDiagnosticsPerformanceCounter

Aggiunge una nuova istanza di un contatore delle prestazioni a un computer Web front-end oppure a un server di database.

Sintassi

AddCounter

Add-SPDiagnosticsPerformanceCounter
    [-Category] <String>
    -Counter <String>
    [-AllInstances]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DatabaseServer]
    [-WebFrontEnd]
    [-WhatIf]
    [<CommonParameters>]

AddInstance

Add-SPDiagnosticsPerformanceCounter
    [-Category] <String>
    -Instance <String>
    [-Counter <String>]
    [-AllInstances]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DatabaseServer]
    [-WebFrontEnd]
    [-WhatIf]
    [<CommonParameters>]

AddMultipleCounters

Add-SPDiagnosticsPerformanceCounter
    [-Category] <String>
    -CounterList <String[]>
    [-Instance <String>]
    [-AllInstances]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-DatabaseServer]
    [-WebFrontEnd]
    [-WhatIf]
    [<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.

Il cmdlet Add-SPDiagnosticsPerformanceCounter aggiunge un contatore delle prestazioni a un server Web front-end oppure a un server di database. I contatori di questo tipo vengono letti e registrati nel database di utilizzo. Per impostazione predefinita, il nuovo contatore delle prestazioni viene aggiunto ai server di database della farm.

Esempio

ESEMPIO 1

C:\PS>Add-SPDiagnosticsPerformanceCounter -category ASP.NET -Counter "Requests Queued"

Questo esempio consente di aggiungere il contatore denominato ASP.NET\Requests Queued nei server Web front-end.

ESEMPIO 2

C:\PS>Add-SPDiagnosticsPerformanceCounter -category PhysicalDisk -counter "Avg. Disk Queue Length" -allinstances

Questo esempio consente di aggiungere tutte le istanze del contatore PhysicalDisk della categoria Avg. Disk Queue Length nei server Web front-end.

ESEMPIO 3:

C:\PS>Add-SPDiagnosticsPerformanceCounter -category Processor -counter "% Processor Time" -instance "_Total" -databaseserver

Questo esempio consente di aggiungere l'istanza _Total del contatore % Processor Time della categoria Processor nei server di database.

Parametri

-AllInstances

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

Raccoglie tutte le istanze di una categoria e di un tipo di contatore nel computer Web front-end o nel server di database di destinazione.

Proprietà dei parametri

Tipo:SwitchParameter
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à:True
Valore dagli argomenti rimanenti:False

-AssignmentCollection

Applicabile: SharePoint Server 2010, 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

-Category

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

Specifica la categoria di contatori delle prestazioni da aggiungere al computer Web front-end o al server di database di destinazione.

Il tipo deve essere un nome valido di una categoria di contatori delle prestazioni, ad esempio ASP.NET, PhysicalDisk o Processor.

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à:True
Valore dagli argomenti rimanenti:False

-Confirm

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

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

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

-Counter

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

Specifica il tipo di contatore da aggiungere al computer Web front-end o al server di database di destinazione.

Il tipo deve essere un nome valido di un tipo di contatore, ad esempio Requests Queued, Avg. Disk Queue Length e % Processor Time.

Proprietà dei parametri

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

Set di parametri

AddCounter
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
AddInstance
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-CounterList

Applicabile: SharePoint Server 2016, SharePoint Server 2019

{{Fill CounterList Description}}

Proprietà dei parametri

Tipo:

String[]

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

Set di parametri

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

-DatabaseServer

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

Aggiunge il contatore delle prestazioni specificato a tutti i server di database della farm.

Proprietà dei parametri

Tipo:SwitchParameter
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à:True
Valore dagli argomenti rimanenti:False

-Instance

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

Specifica il nome visualizzato del nuovo contatore delle prestazioni.

Il tipo deve essere un nome valido di un'istanza di contatore delle prestazioni, ad esempio Totale_ContatorePrest.

Proprietà dei parametri

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

Set di parametri

AddInstance
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
AddMultipleCounters
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WebFrontEnd

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

Aggiunge il contatore delle prestazioni specificato a tutti i computer Web front-end della farm.

Proprietà dei parametri

Tipo:SwitchParameter
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à:True
Valore dagli argomenti rimanenti:False

-WhatIf

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

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

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.