Condividi tramite

Set-SPExcelServiceApplication

Modulo:
SharePointServer module

Imposta le proprietà globali per l'applicazione Excel Services.

Sintassi

ExistingTargetApplicationParameterSet 

Set-SPExcelServiceApplication
    [[-Identity] <SPExcelServiceApplicationPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnattendedAccountApplicationId <String>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

NewTargetApplicationParameterSet 

Set-SPExcelServiceApplication
    [[-Identity] <SPExcelServiceApplicationPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UnattendedServiceAccount <PSCredential>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

Descrizione

Il Set-ExcelServiceApplication cmdlet modifica le proprietà di runtime globali per Excel Services'applicazione. Le modifiche alle proprietà apportate tramite questo cmdlet influiscono su tutti i computer della farm che eseguono un'istanza dell'applicazione del servizio Web applicazione Excel Services specificata.

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 1

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -SessionsPerUserMax 10

In questo esempio viene impostata l'applicazione Excel Services per consentire a ogni utente di aprire non più di 10 sessioni contemporaneamente in un server applicazioni back-end che esegue Excel Services'applicazione.

ESEMPIO 2

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1

In questo esempio il numero massimo di byte privati di memoria nel computer viene impostato sul valore -1, che indica che Excel Services'applicazione utilizzerà il 50% delle risorse di memoria disponibili.

Parametri

-AssignmentCollection

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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

-CachingOfUnusedFilesEnable

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica che i file non più usati da Excel Services'applicazione possono rimanere nella cache per un uso successivo. L'impostazione predefinita è True se il parametro non viene specificato nel comando.

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

-Confirm

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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

-CrossDomainAccessAllowed

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Indica che è possibile richiedere e visualizzare le cartelle di lavoro e i file di connessione dati attendibili in web part o pagine che risiedono in altri domini HTTP.

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

-EncryptedUserConnectionRequired

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Richiede l'uso della crittografia tra l'utente finale e il server che esegue Excel Services'applicazione. L'ambito di questa impostazione è il server logico. Il valore predefinito è None.

Il tipo deve essere uno dei seguenti valori: None o Connection.

Proprietà dei parametri

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

-ExternalDataConnectionLifetime

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il numero massimo di secondi per i quali una connessione dati esterna può rimanere aperta nel pool di connessioni.

I valori validi sono:

-1 Non riciclare mai

Da 1 a 2073600 Resta attivo da 1 secondo a 24 giorni.

Il valore predefinito è 1800.

Proprietà dei parametri

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

-FileAccessMethod

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il metodo di autenticazione utilizzato Excel Services'applicazione per recuperare i file. UseFileAccessAccount specifica che tutte le cartelle di lavoro usano sempre le credenziali dell'account del servizio in esecuzione Excel Services'applicazione. UseImpersonation specifica che Excel Services'applicazione recupera i file della cartella di lavoro come utente che effettua la richiesta. Il valore predefinito è UseImpersonation.

Il tipo deve essere uno dei seguenti valori: UseImpersonation o UseFileAccessAccount.

Proprietà dei parametri

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

-Identity

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica l'oggetto SPExcelServiceApplication da aggiornare.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; un nome valido di un'applicazione del servizio Web applicazione Excel Services nella farm ,ad esempio MyExcelService1, o un'istanza di un oggetto SPExcelServiceApplication valido.

Proprietà dei parametri

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

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LoadBalancingScheme

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica lo schema di bilanciamento del carico utilizzato dall'applicazione del servizio Web applicazione Excel Services per inviare richieste a diversi computer back-end Excel Services applicazioni. Il valore predefinito è WorkbookURL.

Il tipo deve essere uno dei seguenti valori: RoundRobin, Local o WorkbookURL.

Proprietà dei parametri

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

-MemoryCacheThreshold

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica la percentuale del numero massimo di byte privati che è possibile allocare agli oggetti non attivi. Quando viene superata la soglia della cache di memoria, gli oggetti memorizzati nella cache attualmente non utilizzati vengono eliminati. Se il valore è impostato su 0, viene disattivata la memorizzazione nella cache degli oggetti non attivi. Il valore predefinito è 90.

Il tipo deve essere un intero dell'intervallo da 0 a 95.

Proprietà dei parametri

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

-PrivateBytesMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il numero massimo di byte privati, in megabyte, utilizzati da Excel Services Application. Se il valore è impostato su -1, il numero massimo di byte privati per impostazione predefinita sarà pari al 50% del memoria fisica del computer. I valori validi includono -1 (nessun limite) e qualsiasi numero intero positivo. Il valore predefinito è -1.

Il tipo deve essere -1 o qualsiasi intero positivo.

Proprietà dei parametri

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

-SessionsPerUserMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il numero massimo di sessioni consentite per un utente. Se un utente raggiunge il valore massimo, la sessione più datata viene eliminata all'avvio di una nuova sessione. I valori validi includono -1 (nessun limite) e qualsiasi numero intero positivo. Il valore predefinito è 25.

Il tipo deve essere -1 o qualsiasi intero positivo.

Proprietà dei parametri

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

-SiteCollectionAnonymousSessionsMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il numero massimo di sessioni anonime consentito per raccolta siti. Il valore 0 indica che non sono consentite sessioni anonime. I valori validi includono -1 (nessun limite), 0 (disattiva l'impostazione) o qualsiasi numero intero positivo. Il valore predefinito è 25.

Il tipo deve essere -1, 0 o qualsiasi intero positivo.

Proprietà dei parametri

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

-TerminateProcessOnAccessViolation

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Termina Excel Services'applicazione quando si verifica una violazione di accesso nel processo.

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

-ThrottleAccessViolationsPerSiteCollection

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica che se una cartella di lavoro causa un errore di violazione di accesso in Excel Services'applicazione, a tutti i file provenienti dalla raccolta siti della cartella di lavoro viene impedito il caricamento per il periodo specificato (in secondi). Le sessioni già in corso per i file della raccolta siti non sono interessate. I valori validi includono 0, per disattivare l'impostazione, e l'intervallo da 1 a 2073600 secondi (24 giorni). Il valore predefinito è 0.

Il tipo deve essere un valore intero dell'intervallo da 0 a 2073600.

Proprietà dei parametri

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

-UnattendedAccountApplicationId

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica l'ID applicazione utilizzato per la ricerca delle credenziali dell'account di servizio automatico nel servizio di archiviazione sicura specificato dal parametro UnattendedAccountSecureServiceAppName. Il servizio di archiviazione sicura viene contattato quando questo parametro è impostato e si verificano determinate situazioni di errore. I valori validi sono stringhe alfanumeriche contenenti al massimo 256 caratteri. Il valore predefinito è una stringa vuota.

Il tipo deve essere una stringa valida di caratteri alfanumerici, ad esempio IDAccountServizioAutomatico.

L'account automatico è un singolo account che tutte le cartelle di lavoro possono usare per aggiornare i dati. È necessario un account automatico quando le connessioni alla cartella di lavoro specificano Nessuna per l'autenticazione o quando vengono usate credenziali non Windows per aggiornare i dati.

Proprietà dei parametri

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

Set di parametri

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

-UnattendedServiceAccount

Applicabile: SharePoint Server 2013

L'account del servizio automatico è un singolo account che tutte le cartelle di lavoro possono usare per aggiornare i dati. Questo account è necessario per aggiornare i dati quando le connessioni della cartella di lavoro specificano "Usa l'account del servizio automatico" senza usare le credenziali di Windows.

Proprietà dei parametri

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

Set di parametri

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

-UnusedObjectAgeMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica la durata massima, in minuti, dell'intervallo di tempo in cui gli oggetti attualmente non utilizzati in una sessione vengono conservati nella cache di memoria. Tra i valori validi sono inclusi -1 (nessuna impostazione) e un intero positivo dell'intervallo da 1 a 34560 minuti (24 giorni). Il valore predefinito è -1.

Il tipo deve essere -1 o un intero dell'intervallo da 1 a 34560.

Proprietà dei parametri

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

-UseEffectiveUserName

Applicabile: SharePoint Server 2013

La proprietà UseEffectiveUserName è un'alternativa alla delega di Windows per consentire agli utenti di accedere in modo sicuro ai dati di Analysis Services.

L'impostazione influirà solo sulle connessioni dati esterne in base alle connessioni alla cartella di lavoro di Analysis Services con l'impostazione di autenticazione "Usare l'account dell'utente autenticato".

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

-WhatIf

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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

-WorkbookCache

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il percorso del file system locale della cache utilizzata per archiviare le cartelle di lavoro utilizzate da Excel Services'applicazione.

Se non viene specificato alcun valore, il valore predefinito è una sottodirectory della directory temporanea del sistema.

Il tipo deve essere un percorso valido in uno dei formati seguenti:

-- C:\folder_name -- \\server_name\folder_name

Proprietà dei parametri

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

-WorkbookCacheSizeMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica la dimensione massima consentita, espressa in megabyte, per una singola sessione. Il valore predefinito è 0.

Il tipo deve essere un numero intero positivo.

Proprietà dei parametri

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

-WorkbookModelUsageTracker

Applicabile: SharePoint Server 2013

{{Fill WorkbookModelUsageTracker Description}}

Proprietà dei parametri

Tipo:String
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à: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.