Set-OfficeWebAppsFarm

Configura le impostazioni di una farm di Office Online Server esistente.

Sintassi

Set-OfficeWebAppsFarm
   [-Force]
   [-FarmOU <String>]
   [-InternalURL <String>]
   [-ExternalURL <String>]
   [-AllowHttp]
   [-AllowOutboundHttp]
   [-SSLOffloaded]
   [-CertificateName <String>]
   [-S2SCertificateName <String>]
   [-EditingEnabled]
   [-Proxy <String>]
   [-LogLocation <String>]
   [-LogRetentionInDays <UInt32>]
   [-LogVerbosity <String>]
   [-CacheLocation <String>]
   [-MaxMemoryCacheSizeInMB <Int32>]
   [-DocumentInfoCacheSize <UInt32>]
   [-CacheSizeInGB <Int32>]
   [-ClipartEnabled]
   [-TranslationEnabled]
   [-MaxTranslationCharacterCount <Int32>]
   [-TranslationServiceAppId <String>]
   [-TranslationServiceAddress <String>]
   [-RenderingLocalCacheLocation <String>]
   [-RecycleActiveProcessCount <UInt32>]
   [-AllowCEIP]
   [-ExcelRequestDurationMax <Int32>]
   [-ExcelSessionTimeout <Int32>]
   [-ExcelWorkbookSizeMax <Int32>]
   [-ExcelPrivateBytesMax <Int32>]
   [-ExcelConnectionLifetime <Int32>]
   [-ExcelExternalDataCacheLifetime <Int32>]
   [-ExcelAllowExternalData]
   [-ExcelUseEffectiveUserName]
   [-ExcelWarnOnDataRefresh]
   [-ExcelUdfsAllowed]
   [-ExcelMemoryCacheThreshold <Int32>]
   [-ExcelUnusedObjectAgeMax <Int32>]
   [-ExcelCachingUnusedFiles]
   [-ExcelAbortOnRefreshOnOpenFail]
   [-ExcelAutomaticVolatileFunctionCacheLifeTime <Int32>]
   [-ExcelConcurrentDataRequestsPerSessionMax <Int32>]
   [-ExcelDefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
   [-ExcelRestExternalDataEnabled]
   [-ExcelChartAndImageSizeMax <Int32>]
   [-OpenFromUrlEnabled]
   [-OpenFromUncEnabled]
   [-OpenFromUrlThrottlingEnabled]
   [-PicturePasteDisabled]
   [-RemovePersonalInformationFromLogs]
   [-AllowHttpSecureStoreConnections]
   [-WhatIf]
   [-Confirm]

Descrizione

Il cmdlet Set-OfficeWebAppsFarm configura le impostazioni di una farm Office Online Server esistente.

Esempio

------------------ESEMPIO 1---------------------

Set-OfficeWebAppsFarm -ClipartEnabled:$true

In questo esempio viene abilitato l'inserimento di ClipArt da Office.com.

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

Set-OfficeWebAppsFarm -EditingEnabled:$true

In questo esempio viene abilitata la funzionalità di modifica per Office in un browser.

------------------ESEMPIO 3---------------------

Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false

In questo esempio viene disattivata la possibilità di visualizzare un file di Office da un percorso UNC.

Parametri

-AllowCEIP

Abilita la creazione di report del programma Analisi utilizzo software in tutti i server della farm Office Online Server.

Per rendere effettiva questa modifica, è necessario riavviare ogni server della farm Office Online Server.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowHttp

Indica che è necessario effettuare il provisioning dei siti IIS sulla porta 80 per l'accesso HTTP. Utilizzare AllowHTTP solo in ambienti in cui tutti i computer richiedono IPSEC (crittografia completa) o in ambienti di testing in cui non sono contenuti file riservati.

Abilitato automaticamente quando si abilita SSLOffloaded.

Per rendere effettiva la modifica, è necessario riavviare tutti i server della farm.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowHttpSecureStoreConnections

Indica che è possibile creare connessioni di archiviazione sicura utilizzando connessioni non SSL, ad esempio HTTP. Il valore predefinito è False.

Utilizzare AllowHTTPSecureStoreConnections solo in ambienti in cui tutti i computer richiedono IPSEC (crittografia completa) o in ambienti di testing in cui non sono contenuti file riservati.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowOutboundHttp

Consente connessioni HTTP in uscita da Office Online Server.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CacheLocation

Specifica il percorso della cache del disco globale utilizzata per archiviare file di immagine sottoposti a rendering. Il percorso predefinito è %programdata%\Microsoft\OfficeWebApps\Working\d.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CacheSizeInGB

Specifica la dimensione massima della cache del disco globale in gigabyte.

Il tipo deve essere un valore intero compreso tra 0 e un numero intero positivo. La dimensione predefinita è 15 GB.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateName

Specifica il nome descrittivo del certificato usato Office Online Server per creare associazioni HTTPS.

Se il certificato specificato non viene trovato o è scaduto oppure il valore specificato è associato a più certificati, verrà registrato un errore e la farm non verrà creata.

Questo valore viene usato in tutti i server che si uniscono alla farm Office Online Server. Ogni server della farm pertanto deve disporre di un certificato con questo nome descrittivo.

Non è necessario specificare il parametro CertificateName se si usa il parametro AllowHttp o SSLOffloaded.

Per rendere effettiva la modifica, è necessario riavviare tutti i server della farm.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClipartEnabled

Consente il supporto per l'inserimento di ClipArt da Office.com nei documenti di Office. Per utilizzare questa funzionalità è necessaria la comunicazione da server a Web, configurata direttamente oppure usando un proxy specificato mediante il parametro Proxy.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il comando. Per altre 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

-DocumentInfoCacheSize

Specifica il numero massimo di record di conversione di documenti archiviati in una cache di memoria.

Il valore predefinito è 5000 record.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EditingEnabled

Abilita il supporto per la modifica nel browser. Il valore predefinito è False. Impostare True solo se si dispone della licenza appropriata per l'utilizzo della funzionalità di modifica.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelAbortOnRefreshOnOpenFail

Impedisce il caricamento di una cartella di lavoro se l'aggiornamento dei dati non riesce. Consente di impedire agli utenti di visualizzare informazioni non aggiornate o quelle cui potrebbero non avere accesso.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelAllowExternalData

Abilita l'aggiornamento dei dati esterni supportati nelle cartelle di lavoro di Excel in un browser in cui le cartelle di lavoro contengono connessioni a dati esterni. Il valore predefinito è True.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelAutomaticVolatileFunctionCacheLifeTime

Specifica il tempo massimo, in secondi, per cui un valore calcolato per una funzione volatile viene memorizzato nella cache per ricalcoli automatici. -1: Esegue il calcolo una volta quando la cartella di lavoro viene caricata. 0: esegue sempre il calcolo. Da 1 a 2073600: memorizza i dati nella cache per un periodo da 1 secondo a 24 giorni.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelCachingUnusedFiles

Abilitare la memorizzazione nella cache dei file che non sono più in uso da parte di sessioni Excel Web.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelChartAndImageSizeMax

Specifica le dimensioni massime, in megabyte, di un grafico o di un'immagine che possono essere aperte da Excel in un browser. Il valore deve essere un numero intero maggiore di 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelConcurrentDataRequestsPerSessionMax

Specifica il numero massimo di richieste di dati esterne che è possibile effettuare contemporaneamente in ciascuna sessione. Se in una sessione è necessario emettere un numero superiore di richieste, le richieste aggiuntive dovranno essere messe in coda.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelConnectionLifetime

Specifica la durata, in secondi, delle connessioni dati esterne per Excel in un browser. Il valore predefinito è 1800 secondi.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelDefaultWorkbookCalcMode

PARAMVALUE: File | Manual | Auto | AutoDataTables

Type:DefaultWorkbookCalcMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelExternalDataCacheLifetime

Specifica la durata, in secondi, della durata della cache dei dati esterna in Excel in un browser. Il valore predefinito è 300 secondi.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelMemoryCacheThreshold

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. Valori validi: 0 (disattiva la memorizzazione nella cache di oggetti non attivi); da 1 a 95.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelPrivateBytesMax

Specifica il numero massimo di byte privati, in megabyte, usati da Excel in un browser. Se è impostato su -1, il numero massimo di byte privati utilizza il 50% della memoria fisica del computer.

Il tipo deve essere -1 o qualsiasi intero positivo. Il valore predefinito è -1.

Per rendere effettiva la modifica, è necessario riavviare tutti i server della farm.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelRequestDurationMax

Specifica la durata massima, in secondi, di una singola richiesta in una sessione. Al termine di questo intervallo di tempo, si verifica il timeout della richiesta.

Il tipo deve essere -1 (nessun limite) o un intero dell'intervallo da 1 a 2073600. Il valore predefinito è 300.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelRestExternalDataEnabled

Consentire le richieste dell'API REST di aggiornare le connessioni dati esterne. Questa impostazione non ha alcun effetto se Impostazione dati esterni consentiti è impostata su None. Bool della casella di controllo. L'impostazione predefinita è False.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelSessionTimeout

Specifica il tempo, in secondi, in cui una sessione rimane attiva in Excel in un browser quando non è presente alcuna attività utente. Tra i valori validi sono inclusi:

-1 La sessione non scade mai.

0 La sessione scade alla fine di una singola richiesta.

1-2073600 La sessione resta attiva per un intervallo di tempo compreso tra 1 secondo e 24 giorni. Il valore predefinito è 450.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelUdfsAllowed

Abilita Funzioni definite dall'utente per Excel in un browser. Il valore predefinito è False.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelUnusedObjectAgeMax

Il tempo massimo (minuti) in cui gli oggetti non attivi restano nella memoria cache. Gli oggetti non attivi sono oggetti che non vengono usati in una sessione. Valori validi: -1 (nessun valore massimo); da 1 a 34560 (24 giorni). Il valore predefinito è -1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelUseEffectiveUserName

Abilita l'uso del parametro EffectiveUserName di Analysis Services con Excel in un browser. Il valore predefinito è False.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelWarnOnDataRefresh

Disattiva o attiva la finestra di dialogo di avviso visualizzata durante l'aggiornamento dei dati in Excel in un browser.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcelWorkbookSizeMax

Specifica la dimensione massima, in megabyte, di una cartella di lavoro che è possibile caricare.

Il tipo deve essere un valore intero dell'intervallo da 1 a 2000. Il valore predefinito è 10.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExternalURL

Specifica la radice DELL'URL usata dai client per accedere alla farm Office Online Server da Internet. Nel caso di una farm Office Online Server con bilanciamento del carico e multiserver, l'URL esterno è associato all'indirizzo IP del servizio di bilanciamento del carico esterno.

Una farm Office Online Server richiede almeno un URL, che viene impostato tramite ExternalURL o InternalURL. È inoltre possibile impostare URL interni ed esterni.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FarmOU

Specifica il nome dell'unità organizzativa (OU) di Active Directory di cui i server devono essere membri per l'aggiunta alla farm Office Online Server. Usare questo parametro per impedire ai server non autorizzati,ovvero ai server che non si trovano nell'unità organizzativa, di aggiungere una farm Office Online Server.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Elimina le richieste utente fornendo una risposta affermativa.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InternalURL

Specifica la radice URL che i client devono usare per accedere alla farm Office Online Server dalla Intranet.

Una farm Office Online Server richiede almeno un URL. Viene impostato usando ExternalURL o InternalURL. È inoltre possibile impostare URL interni ed esterni.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogLocation

Specifica il percorso del computer locale in cui vengono archiviati i registri attività.

Il percorso si applica a tutti i server della farm e non può essere personalizzato per ogni singolo server. Il percorso predefinito è %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS.

Lasciare spazio su disco sufficiente nell'unità in cui vengono archiviati i registri.

Per rendere effettiva la modifica, è necessario riavviare tutti i server della farm.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogRetentionInDays

Specifica per quanti giorni vengono mantenute le voci di log. Le voci di log che risalgono a un periodo precedente alla data configurata vengono rimosse.

Il tipo deve essere un numero intero compreso tra 0 e 365. Il valore predefinito è 7 giorni.

Per rendere effettiva la modifica, è necessario riavviare tutti i server della farm.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogVerbosity

Specifica il livello di dettagli delle informazioni archiviate nei file di log di traccia. I valori sono i seguenti:

VerboseEX scrive informazioni con livello di dettagli ridotto nel file di log di traccia. Questa impostazione è utile per tracce di volume elevato.

Verbose scrive informazioni con livello di dettagli ridotto nel file di log di traccia.

Medium scrive informazioni con livello di dettagli medio nel file di log di traccia.

High scrive informazioni con livello di dettagli elevato nel file di log di traccia.

Monitorable scrive tracce che rappresentano un percorso di codice anomalo e azioni che devono essere monitorate.

Unexpected scrive tracce che rappresentano un percorso di codice imprevisto e azioni che devono essere monitorate.

None non scrive alcuna informazione di traccia nel file di log di traccia.

Il parametro LogVerbosity impostato su un valore basso per un lungo periodo di tempo produce un effetto negativo sulle prestazioni.

Per rendere effettiva la modifica, è necessario riavviare tutti i server della farm.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxMemoryCacheSizeInMB

Specifica, in megabyte, la quantità massima di memoria che può essere utilizzata dalla cache di rendering.

Il tipo deve essere un valore intero compreso tra 0 e un numero intero positivo. La dimensione predefinita è 1024 MB.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxTranslationCharacterCount

Specifica il numero massimo di caratteri che un documento può includere per essere tradotto.

Il tipo deve essere un valore intero. Il valore può essere impostato su 0 per indicare che non è presente alcun limite oppure su un valore compreso tra 2000 e 2.000.000. Il valore predefinito è 125.000.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OpenFromUncEnabled

Attiva o disattiva la possibilità di utilizzare Visualizzatori online per visualizzare i file di Office da un percorso UNC.

È necessario innanzitutto impostare OpenFromUrlEnabled su True per consentire a Visualizzatori online di visualizzare i file in percorsi UNC.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OpenFromUrlEnabled

Attiva o disattiva la possibilità di usare visualizzatori online per visualizzare i file di Office da un url o un percorso UNC.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OpenFromUrlThrottlingEnabled

Limita il numero di richieste di apertura da URL di un server specifico in un determinato intervallo di tempo. I valori di limitazione predefiniti, che non sono configurabili, assicurarsi che una farm Office Online Server non sovraccarici un singolo server con richieste di contenuto da visualizzare nei visualizzatori online.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PicturePasteDisabled

Disattiva la possibilità per gli utenti di incollare immagini da una pagina Web in Office in un browser. Il valore predefinito è False. Se OpenFromURLEnabled è impostato su True e PicturePasteDisabled non è impostato o impostato su False, gli utenti possono incollare immagini in Office in un browser.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Specifica l'URL del server proxy configurato per consentire le richieste HTTP per siti esterni. Questo parametro in genere è configurato insieme ai parametri ClipartEnabled e TranslationEnabled.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecycleActiveProcessCount

Specifica il numero di file di cui un singolo processo di Word o PowerPoint può eseguire il rendering prima che il processo venga riciclato.

Il tipo deve essere un numero intero compreso tra 1 e 1000. Il valore predefinito è 5.

Per rendere effettiva la modifica, è necessario riavviare tutti i server della farm.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemovePersonalInformationFromLogs

Fornisce una pulitura ottimale delle informazioni personali dai log Office Online Server e sostituisce i valori con un hash SHA256. Le informazioni di cui è possibile eseguire lo scrubbing sono:

Nomi di documento e URL

Indirizzi IP

Indirizzi di posta elettronica

Nomi utente

Il valore predefinito è False. Si noti che l'abilitazione di questo parametro non garantisce che le informazioni personali non vengano registrate nei log di Office Online Server.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RenderingLocalCacheLocation

Specifica il percorso della cache temporanea per l'uso da parte di Word e PowerPoint Viewing Services.

Il percorso predefinito è %programdata%\Microsoft\OfficeWebApps\Working\waccache.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-S2SCertificateName

Nome descrittivo del certificato da usare per l'autenticazione da server a server con SharePoint Server.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SSLOffloaded

Indica ai server della farm Office Online Server che SSL viene scaricato nel servizio di bilanciamento del carico. Quando SSLOffloaded è abilitato, le applicazioni Web sono associate alla porta 80 (HTTP) nel server locale. Per HTML che fa riferimento ad altre risorse, ad esempio fogli di stile CSS o immagini, vengono utilizzati invece gli URL HTTPS per i riferimenti.

Per rendere effettiva la modifica, è necessario riavviare tutti i server della farm.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TranslationEnabled

Abilita il supporto per la traduzione automatica dei documenti tramite Microsoft Translator, un servizio online per la traduzione di testo da una lingua a un'altra. Il file tradotto viene visualizzato in Word. Poiché Microsoft Translator è un servizio online, è necessario abilitare la comunicazione da server a Web direttamente oppure tramite un proxy specificato utilizzando il parametro Proxy.

È possibile che Microsoft Translator raccolga dati per migliorare la qualità delle traduzioni.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TranslationServiceAddress

Specifica l'URL del server di traduzione a cui vengono inviate richieste di traduzione. Il valore predefinito è il servizio online Microsoft Translator. Questo parametro in genere non viene utilizzato, a meno che non sia necessario cambiare servizi di traduzione.

Per rendere effettiva questa modifica, è necessario riavviare ogni server della farm Office Online Server.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TranslationServiceAppId

Specifica l'ID applicazione del servizio di traduzione. L'impostazione predefinita è l'ID applicazione pubblica per Office in un browser. Questo parametro in genere non viene utilizzato, a meno che non siano stati negoziati servizi aggiuntivi con Microsoft Translator e che tali servizi non siano stati forniti con un ID applicazione privato.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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