Cmdlet Set-PowerPivotServiceApplication

Consente di impostare le proprietà di un'applicazione del servizio PowerPivot.

Sintassi

Set-PowerPivotServiceApplication [-Identity] <SPGeminiServiceApplicationPipeBind> [-AdministrationConnectionPoolSize <int>] [-AllowCustomWindowsCredentials] [-BusinessHoursEndTime <string>] [-BusinessHoursStartTime <string>] [-CachedDatabaseholdLimit <int>] [-Confirm <switch>] [-ConnectionPoolSize <int>] [-ConnectionPoolTimeout <int>] [-DataLoadTimeout <int>] [-DataRefreshFailureThreshold <int>] [-DataRefreshInactiveWorkbooksThreshold <int>] [-DataRefreshMaxHistory <int>] [-HealthBasedAllocation <switch>] [-LoadsToConnectionsRatioCollectionInterval <int>] [-LoadsToConnectionsRatioLimit <int>] [-MemoryDatabaseHoldLimit <int>] [-QueryReportingInterval <int>] [-RoundRobinAllocation <switch>] [-UnattendedAccount <string>] [-UsageDataRetentionPeriod <int>] [-UsageExpectedResponseUpperLimit <int>] [-UsageLongResponseUpperLimit <int>] [-UsageQuickResponseUpperLimit <int>] [-UsageTrivialResponseUpperLimit <int>] [-UsageUpdateDayLimit <int>] [<CommonParameters>]

Descrizione

Il cmdlet Set-PowerPivotServiceApplication consente di aggiornare le proprietà di un'applicazione del servizio PowerPivot nella farm. Il parametro Identity è obbligatorio. È necessario fornire il GUID dell'applicazione di servizio per la quale si stanno aggiornando le proprietà.

Per verificare le modifiche, eseguire il cmdlet seguente: Get-PowerPivotServiceApplication -Identity <GUID> | format-list.

Parametri

-Identity <SPGeminiServiceApplicationPipeBind>

Consente di specificare l'applicazione di servizio da aggiornare. Il tipo deve essere un GUID valido o un'istanza di un oggetto applicazione del servizio PowerPivot valido. È possibile utilizzare Get-PowerPivotServiceApplication per restituire un'istanza dell'oggetto.

-AdministrationConnectionPoolSize <int>

Consente di specificare il numero di connessioni aperte in un pool di connessioni creato per una connessione del servizio PowerPivot ad Analysis Services. In ogni istanza del servizio PowerPivot viene aperta una connessione amministrativa separata all'istanza di Analysis Services nello stesso computer. Il servizio PowerPivot consente di creare un pool separato per riutilizzare le connessioni amministrative allo scopo di verificare la presenza di connessioni inattive e monitorare l'integrità del server. Il valore predefinito è 200 connessioni. I valori validi sono -1 (senza limiti), 0 (pool di connessioni amministrative disabilitati) oppure un valore compreso tra 1 e 10000. Se si seleziona 0, ogni connessione verrà creata da zero.

-AllowCustomWindowsCredentials [<SwitchParameter>]

Consente di specificare se i proprietari della pianificazione possono immettere credenziali di Windows arbitrarie per eseguire una pianificazione dell'aggiornamento dati. Se si seleziona questa casella di controllo, l'applicazione del servizio PowerPivot consentirà di creare e gestire un'applicazione di destinazione per ciascun set di credenziali archiviate. L'impostazione predefinita è true. Per disabilitare questa funzionalità, impostare AllowCustomWindowsCredentials:$false.

-BusinessHoursEndTime <string>

Consente di specificare il punto finale in un intervallo di ore che definisce un giorno lavorativo. Le pianificazioni dell'aggiornamento dati possono essere eseguite al termine di un giorno lavorativo per selezionare i dati transazionali generati durante il normale orario di ufficio. L'impostazione predefinita è 8:00 p.m. I valori validi vengono specificati tra virgolette, con l'indicazione a.m. o p.m., ad esempio, "08:00PM". Le ore devono essere comprese nell'intervallo da 1 a 12. I minuti devono essere compresi nell'intervallo da 1 a 59.

Per specificare l'intervallo completo di ore per un giorno lavorativo, è necessario impostare sia BusinessHoursStartTime che BusinessHoursEndTime. I due parametri definiscono l'intervallo di ore che costituisce un giorno lavorativo.

-BusinessHoursStartTime <string>

Consente di specificare il punto iniziale in un intervallo di ore che definisce un giorno lavorativo. Le pianificazioni dell'aggiornamento dati possono essere eseguite al termine di un giorno lavorativo per selezionare i dati transazionali generati durante il normale orario di ufficio. L'impostazione predefinita è 4:00 a.m. I valori validi vengono specificati tra virgolette, con l'indicazione a.m. o p.m., ad esempio, "04:00AM". Le ore devono essere comprese nell'intervallo da 1 a 12. I minuti devono essere compresi nell'intervallo da 1 a 59.

Per specificare l'intervallo completo di ore per un giorno lavorativo, è necessario impostare sia BusinessHoursStartTime che BusinessHoursEndTime. I due parametri definiscono l'intervallo di ore che costituisce un giorno lavorativo.

-CachedDatabaseholdLimit <int>

Consente di specificare il numero di ore di permanenza di un database inattivo nel file system dopo essere stato scaricato dalla memoria. L'impostazione predefinita è 120 ore. Questa impostazione viene utilizzata dal processo di pulizia per determinare i file da eliminare. Tutti i database PowerPivot che sono inattivi per 168 ore (48 ore in memoria e 120 nella cache) vengono eliminati dal disco dal processo di pulizia.

-Confirm <switch>

Viene richiesta la conferma dell'utente prima dell'esecuzione del comando. Questo valore è abilitato per impostazione predefinita. Per ignorare la risposta di conferma in un comando, specificare Confirm:$false nel comando.

-ConnectionPoolSize <int>

Consente di specificare il numero massimo di connessioni inattive create dal servizio PowerPivot nei singoli pool di connessioni per ogni combinazione di versione, set di dati PowerPivot e utente di SharePoint. Il valore predefinito è 1000 connessioni inattive. I valori validi sono -1 (senza limiti), 0 (pool di connessioni utente disabilitati) oppure un valore compreso tra 1 e 10000. Questi pool di connessioni consentono al servizio di supportare in modo più efficiente connessioni in corso agli stessi dati in sola lettura da parte dello stesso utente. Se si disabilita pool di connessioni, ogni connessione sarà creata di nuovo. La modifica del limite sulle dimensioni dei pool di connessioni, anche se impostata a 0, non causa l'interruzione delle connessioni. I pool di connessioni hanno la funzione di ridurre i tempi di attesa durante la connessione ai dati. Tramite il servizio PowerPivot non verrà mai negata una connessione in base alle impostazioni del pool di connessioni.

-ConnectionPoolTimeout <int>

Consente di specificare per quanti minuti rimane aperta una connessione dati inattiva. Il valore predefinito è 1800 secondi (o 30 minuti). Durante questo periodo di tempo, la connessione dati inattiva verrà riutilizzata dall'applicazione del servizio PowerPivot per le richieste di sola lettura provenienti dallo stesso utente di SharePoint per gli stessi dati PowerPivot. Se non vengono ricevute ulteriori richieste di dati durante il periodo specificato, la connessione viene rimossa dal pool. I valori validi sono compresi tra 1 e 3600 secondi.

-DataLoadTimeout <int>

Consente di specificare il tempo di attesa da parte di un'applicazione del servizio PowerPivot per una risposta dall'istanza di SQL Server Analysis Services (PowerPivot) a cui è stata inoltrata una richiesta di caricamento dati. Poiché lo spostamento di set di dati di dimensioni molto elevate richiede tempo, è necessario consentire un tempo sufficiente all'istanza del servizio PowerPivot per recuperare la cartella di lavoro di Excel e spostare i dati PowerPivot in un'istanza di Analysis Services per l'elaborazione delle query. Il valore predefinito è 1800 secondi (o 30 minuti). I valori validi sono compresi tra 1 e 3600 secondi.

-DataRefreshFailureThreshold <int>

Consente di specificare il numero di errori consecutivi dopo cui viene disabilitata una pianificazione. Il valore predefinito è 10. È possibile anche immettere 0 per non disabilitare mai una pianificazione a causa di errori di aggiornamento.

-DataRefreshInactiveWorkbooksThreshold <int>

Consente di specificare il numero di cicli di aggiornamento dati dopo cui una pianificazione viene disabilitata oppure immettere 0 per non disabilitare mai una pianificazione a causa dell'inattività. Il valore predefinito è 10 cicli.

L'inattività della cartella di lavoro viene misurata come assenza di eventi di connessione in più cicli di aggiornamento dati. Un ciclo di aggiornamento dati viene contato ogni volta che viene attivata un'operazione di aggiornamento dati (dalla pianificazione o da un'operazione Esegui ora), indipendentemente dall'esito positivo o negativo dell'operazione. Se un certo numero di cicli (10 per impostazione predefinita) passa senza alcuna richiesta di connessione per la cartella di lavoro, la pianificazione di aggiornamento dati viene disabilitata a causa dell'inattività.

-DataRefreshMaxHistory <int>

Specifica per quanto tempo mantenere un record cronologico di elaborazione dell'aggiornamento dati. Queste informazioni vengono visualizzate nelle pagine della cronologia dell'aggiornamento dati mantenute per ogni cartella di lavoro per cui viene utilizzato l'aggiornamento dati. Vengono inoltre visualizzate nel dashboard di gestione PowerPivot. Il valore predefinito è 365 giorni.

-HealthBasedAllocation <switch>

Consente di specificare un algoritmo di allocazione basato sull'integrità tramite cui vengono inoltrate le richieste di connessione al server PowerPivot per SharePoint in cui sono disponibili maggiori risorse di memoria e CPU. Si tratta dell'algoritmo di allocazione predefinito. HealthBasedAllocation e RoundRobinBasedAllocation si escludono a vicenda. È necessario specificare uno o l'altro. Se si impostano entrambi su false, viene utilizzato HealthBasedAllocation, in quanto corrisponde al valore predefinito. Se si impostano entrambi su true, viene generato un errore di convalida. La sintassi per questi parametri prevede l'immissione solo del nome del parametro oppure parameter:$true o parameter:$false.

-LoadsToConnectionsRatioCollectionInterval <int>

Consente di specificare l'intervallo (in ore) per il conteggio di eventi di caricamento e di connessione al fine di calcolare il rapporto carico/connessioni. Per impostazione predefinita, nel sistema viene calcolato un nuovo rapporto ogni 4 ore. I valori validi sono compresi tra 1 e 24.

-LoadsToConnectionsRatioLimit <int>

Consente di specificare il rapporto tra eventi di caricamento ed eventi di connessione, utilizzato come indicatore dell'integrità del server. Il valore predefinito corrisponde al 20%.

-MemoryDatabaseHoldLimit <int>

Consente di specificare il numero di ore di permanenza in memoria di un database inattivo per soddisfare nuove richieste per tali dati. Un database attivo viene mantenuto sempre in memoria purché vengano eseguite query su di esso. Una volta inattivo, tuttavia, viene mantenuto in memoria per un ulteriore periodo di tempo, in caso vi siano ulteriori richieste per tali dati. L'impostazione predefinita è 48 ore.

-QueryReportingInterval <int>

Consente di specificare il numero di secondi per la raccolta delle statistiche relative alle risposte alle query prima che le statistiche vengano incluse in un report come evento di utilizzo. Il valore predefinito è 300 secondi.

-RoundRobinAllocation <switch>

Consente di specificare l'algoritmo di allocazione round robin tramite cui vengono inoltrate le richieste di connessione al server PowerPivot per SharePoint successivo, alternando le richieste in modo equivalente tra i server disponibili, indipendentemente dal carico del server. HealthBasedAllocation e RoundRobinBasedAllocation si escludono a vicenda. È necessario specificare uno o l'altro. Se si impostano entrambi su false, viene utilizzato HealthBasedAllocation, in quanto corrisponde al valore predefinito. Se si impostano entrambi su true, viene generato un errore di convalida. La sintassi per questi parametri prevede l'immissione solo del nome del parametro oppure parameter:$true o parameter:$false.

-UnattendedAccount <string>

Consente di specificare il nome dell'applicazione di destinazione di un'applicazione del servizio di archiviazione sicura tramite cui viene archiviato un account predefinito per l'esecuzione dei processi di aggiornamento dati PowerPivot.

-UsageDataRetentionPeriod <int>

Consente di specificare il numero di giorni per la conservazione di una cronologia di dati di utilizzo e delle statistiche di integrità del server. Il valore predefinito è 365 giorni. Se si imposta questo valore su 0, tutta la cronologia viene conservata per un tempo illimitato.

-UsageExpectedResponseUpperLimit <int>

Consente di impostare un limite massimo che definisce uno scambio richiesta-risposta previsto. Il valore predefinito è 3000 millisecondi. Qualsiasi richiesta completata entro un intervallo di tempo compreso tra 1000 e 3000 millisecondi viene considerata una risposta prevista ai fini del report.

-UsageLongResponseUpperLimit <int>

Consente di impostare un limite massimo che definisce uno scambio richiesta-risposta con esecuzione prolungata. Il limite massimo è 10000 millisecondi. Tutte le richieste che superano questo limite massimo rientrano nella categoria Superato, che non prevede una soglia massima.

-UsageQuickResponseUpperLimit <int>

Consente di impostare un limite massimo che definisce uno scambio richiesta-risposta rapido. Il valore predefinito è 1000 millisecondi. Qualsiasi richiesta completata entro un intervallo di tempo compreso tra 500 e 1000 millisecondi viene considerata una risposta rapida ai fini del report.

-UsageTrivialResponseUpperLimit <int>

Consente di specificare una categoria di tempi di risposta che sono troppo piccoli per essere considerati rilevanti ai fini della raccolta dati. La maggior parte delle risposte che rientrano in questa categoria è costituita da comunicazioni tra server. Il valore predefinito è 500 millisecondi. Qualsiasi richiesta completata entro un intervallo di tempo compreso tra 0 e 500 millisecondi viene considerata una richiesta semplice e ignorata ai fini del report.

-UsageUpdateDayLimit <int>

Consente di specificare la soglia (in giorni) per l'attivazione di un avviso relativo a un errore di aggiornamento del file di dati utilizzato dai report nel dashboard di gestione PowerPivot. Per impostazione predefinita, i dati di utilizzo vengono aggiornati dal sistema giornalmente. Il file PowerPivot Management Dashboard.xlsx, che rappresenta l'origine dati per i report amministrativi, viene aggiornato in base alla stessa pianificazione. Se il file con estensione xlsx non viene aggiornato per un determinato numero di giorni, viene attivata una regola di analisi dell'integrità che indica che il file è non aggiornato. Il valore predefinito è 5 giorni. I valori validi sono compresi tra 1 e 30.

<CommonParameters>

Questo cmdlet supporta i parametri comuni, ovvero Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer e OutVariable. Per ulteriori informazioni, vedere About_CommonParameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile inoltrare tramite pipe al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Esempio 1

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklm -AllowCustomWindowsCredentials:$false -UnattendedAccount "MyTargetApp"

In questo esempio viene disabilitata una funzionalità di aggiornamento dati che consente di creare e gestire automaticamente le applicazioni di destinazione del servizio di archiviazione sicura per l'archiviazione di credenziali di Windows arbitrarie. Viene inoltre impostato l'account di aggiornamento dati automatico PowerPivot in un'applicazione di destinazione predefinita.

Utilizzare Get-powerpivotserviceapplication per ottenere un'identità valida.

Esempio 2

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklm -HealthBasedAllocation

In questo esempio viene specificato l'algoritmo di allocazione basato sull'integrità tramite cui vengono inoltrate le richieste di connessione al server in cui sono disponibili maggiori risorse.

Utilizzare Get-powerpivotserviceapplication per ottenere un'identità valida.

Esempio 3

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklmn -BusinessHoursStartTime "07:15AM" -BusinessHoursEndTime "08:00PM"

In questo esempio viene illustrato come impostare le ore di inizio e di fine di un giorno lavorativo, da utilizzare come opzione per la pianificazione dell'aggiornamento dati PowerPivot. Nelle pianificazioni può essere specificata un'opzione successiva all'orario di ufficio, per l'esecuzione dell'aggiornamento dati alla fine di un giorno lavorativo.

Utilizzare Get-powerpivotserviceapplication per ottenere un'identità valida.