Set-SPUsageService
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 5Gli 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 |