Condividi tramite


New-SPExcelServiceApplication

Crea una nuova istanza dell'applicazione Excel Services.

Sintassi

New-SPExcelServiceApplication
   -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
   [-Name <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-Default]
   [-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>]
New-SPExcelServiceApplication
   -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
   [-Name <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-Default]
   [-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 New-SPExcelServiceApplication cmdlet crea una nuova Excel Services'applicazione del servizio Web applicazione con nuove impostazioni. Dopo aver creato una nuova Excel Services'applicazione del servizio Web applicazione, è possibile usare il Set-SPExcelServiceApplication cmdlet per modificare le impostazioni globali della nuova applicazione.

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

New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"

In questo esempio viene creata una nuova istanza di Excel Services Application con il nome visualizzato MyExcelService.

------------------ESEMPIO 2------------------

New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5

In questo esempio viene creata una nuova istanza di Excel Services Application con il nome visualizzato My Excel Service e vengono consentite solo cinque sessioni per utente per ogni computer server applicazioni back-end che esegue Excel Services'applicazione.

Parametri

-ApplicationPool

Specifica il pool di applicazioni IIS esistente in cui eseguire il servizio Web per la nuova applicazione Excel Services.

Il tipo deve essere un oggetto SPIisWebServiceApplicationPool valido.

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

-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

-CachingOfUnusedFilesEnable

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.

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

-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

-CrossDomainAccessAllowed

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.

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

-Default

Specifica che il proxy per questa applicazione di servizio viene aggiunto al gruppo di proxy predefinito della farm.

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

-EncryptedUserConnectionRequired

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

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

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

-ExternalDataConnectionLifetime

Specifica il numero massimo di secondi per i quali una connessione dati esterna può rimanere aperta nel pool di connessioni. Tra i valori validi sono inclusi:

-1 Non riciclare mai

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

Il valore predefinito è 1800.

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

-FileAccessMethod

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.

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

-LoadBalancingScheme

Specifica lo schema di bilanciamento del carico utilizzato dall'applicazione del servizio Web applicazione Excel Services per l'invio di richieste a computer back-end diversi che eseguono Servizi di calcolo Excel. Il valore predefinito è WorkbookURL.

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

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

-MemoryCacheThreshold

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.

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

-Name

Specifica un nome descrittivo per la nuova applicazione del servizio Web applicazione Excel Services. Il nome usato deve essere un nome univoco di un'applicazione del servizio Web applicazione Excel Services presente in questa farm. La lunghezza massima del nome è 128 caratteri. Il valore predefinito è Service_numapplicazioni+1.

Il tipo deve essere una stringa valida, ad esempio AppServizioExcel1.

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

-PrivateBytesMax

Specifica il numero massimo di byte privati, in megabyte, utilizzati da Excel Services'applicazione. 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.

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

-SessionsPerUserMax

Specifica il numero massimo di sessioni consentite per un utente. Se un utente raggiunge il valore massimo, la sessione più datata verrà 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.

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

-SiteCollectionAnonymousSessionsMax

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.

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

-TerminateProcessOnAccessViolation

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

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

-ThrottleAccessViolationsPerSiteCollection

Specifica che se una cartella di lavoro causa un errore di violazione di accesso in Excel Services'applicazione, a tutti i file originati 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.

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

-UnattendedAccountApplicationId

Specifica l'ID applicazione utilizzato per la ricerca delle credenziali dell'account di servizio automatico nel servizio di archiviazione sicura specificato da 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 della cartella di lavoro specificano Nessuna per l'autenticazione o quando vengono usate credenziali non Windows per aggiornare i dati.

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

-UnattendedServiceAccount

{{Fill UnattendedServiceAccount Description}}

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

-UnusedObjectAgeMax

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.

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

-UseEffectiveUserName

{{Fill UseEffectiveUserName Description}}

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

-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

-WorkbookCache

Specifica il percorso del file system locale della cache utilizzata per archiviare le cartelle di lavoro usate 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

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

-WorkbookCacheSizeMax

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

Il tipo deve essere un numero intero positivo.

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

-WorkbookModelUsageTracker

{{Fill WorkbookModelUsageTracker Description}}

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