Add-SPDiagnosticsPerformanceCounter

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

Sintassi

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

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.

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

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Category

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.

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

-Confirm

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

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

-Counter

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.

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

-CounterList

{{Fill CounterList Description}}

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

-DatabaseServer

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

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

-Instance

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.

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

-WebFrontEnd

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

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

-WhatIf

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

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