Set-SPUsageService

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

Aggiorna le proprietà di un servizio di utilizzo.

Sintassi

Set-SPUsageService
   [[-Identity] <SPUsageServicePipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-LoggingEnabled <Boolean>]
   [-UsageLogCutTime <UInt32>]
   [-UsageLogLocation <String>]
   [-UsageLogMaxFileSizeKB <UInt32>]
   [-UsageLogMaxSpaceGB <UInt32>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Il Set-SPUsageService cmdlet aggiorna le proprietà di un servizio di utilizzo. Se non si specifica il parametro Identity, le modifiche verranno applicate al servizio di utilizzo locale.

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-----------------

Set-SPUsageService -LoggingEnabled $false

Set-SPUsageService -UsageLogLocation "D:\\testusagelogdir"


Set-SPUsageService -UsageLogCutTime 5

Gli esempi disabilitano la registrazione dell'utilizzo, modificano la directory in cui vengono archiviati i file di utilizzo e creano un nuovo file di log di utilizzo ogni 5 minuti.

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 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

-Identity

Specifica il servizio di utilizzo da aggiornare.

Il tipo deve essere in uno dei formati seguenti:

--Un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh --Nome valido di un servizio di utilizzo (ad esempio UsageService1) -- Istanza di un oggetto SPUsageService valido.

Type:SPUsageServicePipeBind
Position:1
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

-LoggingEnabled

Specifica che i dati di utilizzo vengono registrati nei relativi file.

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

-UsageLogCutTime

Specifica per quanti minuti vengono raccolti i dati di utilizzo per ogni file di registro dei dati di utilizzo. L'intervallo predefinito è di 5 minuti.

Il valore deve essere un numero intero compreso tra 1 e 1440.

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

-UsageLogLocation

Specifica il percorso di ogni computer della farm in cui vengono creati i file di registro.

Il valore deve essere un percorso locale valido nel formato seguente:

  • C:\nome_cartella
Type:String
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

-UsageLogMaxFileSizeKB

Specifica la dimensione massima di un singolo file di dati di utilizzo da applicare a tutti i provider di dati di utilizzo.

Il valore minimo è 512 kilobyte (KB) e il valore massimo è 65536 KB.

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

-UsageLogMaxSpaceGB

Quantità massima di spazio (misurata in gigabyte) consentita per i log di utilizzo. Sebbene il parametro sia presente nelle versioni successive di SharePoint Server, è applicabile solo a SharePoint Server 2010.

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