Set-OfficeWebAppsFarm

Syntaxe

Default (Par défaut)

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]

Description

Exemples

EXEMPLE 1

Set-OfficeWebAppsFarm -ClipartEnabled:$true

EXEMPLE 2

Set-OfficeWebAppsFarm -EditingEnabled:$true

EXEMPLE 3

Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false

Paramètres

-AllowCEIP

Active les rapports du programme d’amélioration du produit (CEIP) sur tous les serveurs de la batterie de Office Online Server.

Vous devez redémarrer tous les serveurs de la batterie de Office Online Server pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-AllowHttp

Indique que les sites IIS doivent être provisionnés sur le port 80 pour l’accès HTTP. Utilisez AllowHTTP uniquement dans les environnements où tous les ordinateurs requièrent IPsec (chiffrement intégral) ou dans les environnements de test qui ne contiennent pas de fichiers sensibles.

Activé automatiquement quand vous activez SSLOffloaded.

Vous devez redémarrer chaque serveur de la batterie pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-AllowHttpSecureStoreConnections

Indique que les connexions à la Banque d'informations sécurisée peuvent être effectuées à l'aide de connexions non SSL (par exemple, HTTP). La valeur par défaut est False.

Utilisez AllowHTTPSecureStoreConnections uniquement dans les environnements où tous les ordinateurs nécessitent la sécurité IPsec (chiffrement intégral) ou dans les environnements de test qui ne contiennent pas de fichiers sensibles.

Propriétés du paramètre

Jeux de paramètres

-AllowOutboundHttp

Autorise les connexions HTTP sortantes à partir de Office Online Server.

Propriétés du paramètre

Jeux de paramètres

-CacheLocation

Spécifie l'emplacement du cache disque global utilisé pour stocker les fichiers image rendus. L’emplacement par défaut est %programdata%\Microsoft\OfficeWebApps\Working\d\.

Propriétés du paramètre

Jeux de paramètres

-CacheSizeInGB

Spécifie la taille maximale du cache disque global en Go. Le type doit être une valeur entière comprise dans la plage 0 à tout entier positif. La taille par défaut s'élève à 15 Go.

Propriétés du paramètre

Jeux de paramètres

-CertificateName

Spécifie le nom convivial du certificat que Office Online Server utilise pour créer des liaisons HTTPS.

Si le certificat spécifié est introuvable ou a expiré, ou si la valeur spécifiée est associée à plusieurs certificats, une erreur est consignée dans le journal et la batterie n'est pas créée.

Cette valeur est utilisée sur chaque serveur qui joint la batterie de Office Online Server. Par conséquent, chaque serveur inclus dans la batterie doit comporter un certificat portant ce nom convivial.

Vous n’avez pas besoin de spécifier le paramètre CertificateName si vous utilisez le paramètre AllowHttp ou SSLOffloaded.

Vous devez redémarrer chaque serveur de la batterie pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-ClipartEnabled

Active la prise en charge de l’insertion d’images clipart à partir de Office.com dans des documents Office. Cette fonctionnalité requiert une communication entre le serveur et le web, configurée soit directement, soit à l'aide d'un proxy que vous spécifiez à l'aide du paramètre Proxy.

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous demande une confirmation avant d’exécuter la commande.

Propriétés du paramètre

Jeux de paramètres

-DocumentInfoCacheSize

Spécifie le nombre maximal d'enregistrements de conversion de documents stockés dans un cache mémoire.

La valeur par défaut s'élève à 5 000 enregistrements.

Propriétés du paramètre

Jeux de paramètres

-EditingEnabled

Active la prise en charge des modifications dans le navigateur. La valeur par défaut est False. Prend uniquement la valeur True si vous disposez de la licence appropriée pour utiliser la fonctionnalité de modification.

Propriétés du paramètre

Jeux de paramètres

-ExcelAbortOnRefreshOnOpenFail

Empêche le chargement d’un classeur en cas d’échec de l’actualisation des données. Empêche les utilisateurs de voir des informations obsolètes ou, éventuellement, des informations auxquelles ils ne doivent pas avoir accès.

Propriétés du paramètre

Jeux de paramètres

-ExcelAllowExternalData

Active l’actualisation des données externes prises en charge dans les classeurs Excel dans un navigateur où les classeurs contiennent des connexions à des données externes. La valeur par défaut est True.

Propriétés du paramètre

Jeux de paramètres

-ExcelAutomaticVolatileFunctionCacheLifeTime

Spécifie la durée maximale, en secondes, de mise en cache d’une valeur calculée pour une fonction volatile à des fins de recalcul automatique.

• -1 : calcule une fois au chargement du classeur
• 0 : calcule toujours
• entre 1 et 2073600 : mise en cache entre 1 seconde et 24 jours.

Propriétés du paramètre

Jeux de paramètres

-ExcelCachingUnusedFiles

Active la mise en cache des fichiers qui ne sont plus utilisés par des sessions Web Excel.

Propriétés du paramètre

Jeux de paramètres

-ExcelChartAndImageSizeMax

Spécifie la taille maximale, en mégaoctets, d’un graphique ou d’une image qui peut être ouvert par Excel dans un navigateur. La valeur doit être un entier supérieur à 0.

Propriétés du paramètre

Jeux de paramètres

-ExcelConcurrentDataRequestsPerSessionMax

Spécifie le nombre maximal de demandes de données externes simultanées autorisé par session. Si une session doit émettre plus de demandes que le nombre autorisé, les demandes supplémentaires sont mises en file d’attente.

Propriétés du paramètre

Jeux de paramètres

-ExcelConnectionLifetime

Spécifie la durée, en secondes, des connexions de données externes pour Excel dans un navigateur. La valeur par défaut est 1800 secondes.

Propriétés du paramètre

Jeux de paramètres

-ExcelDefaultWorkbookCalcMode

PARAMVALUE : File | Manual | Auto | AutoDataTables

Propriétés du paramètre

Jeux de paramètres

-ExcelExternalDataCacheLifetime

Spécifie la durée, en secondes, de la durée de vie du cache de données externes dans Excel dans un navigateur. La valeur par défaut est 300 secondes.

Propriétés du paramètre

Jeux de paramètres

-ExcelMemoryCacheThreshold

Pourcentage du maximum d’octets privés qui peut être alloué aux objets inactifs. Lorsque le seuil de mémoire cache est dépassé, les objets mis en cache qui ne sont pas utilisés sont sortis. Valeurs valides : 0 (désactive la mise en cache des objets inactifs) ; de 1 à 95.

Propriétés du paramètre

Jeux de paramètres

-ExcelPrivateBytesMax

Spécifie le nombre maximal d’octets privés, en mégaoctets, utilisés par Excel dans un navigateur. Quand la valeur est -1, le nombre maximal d'octets privés utilise 50 % de la mémoire physique de l'ordinateur.

Le type doit être -1 ou tout entier positif. La valeur par défaut est -1.

Vous devez redémarrer chaque serveur de la batterie pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-ExcelRequestDurationMax

Spécifie la durée maximale, en secondes, d'une demande unique dans une session. Une fois ce délai passé, la demande expire.

Le type doit être -1 (illimité) ou un entier compris entre 1 et 2073600. La valeur par défaut est 300.

Propriétés du paramètre

Jeux de paramètres

-ExcelRestExternalDataEnabled

Autorise les demandes de l’API REST visant à actualiser les connexions aux données externes. Ce paramètre n’a aucun effet si l’option Autoriser les données externes est définie sur None. Cochez la case Bool. La valeur par défaut est False.

Propriétés du paramètre

Jeux de paramètres

-ExcelSessionTimeout

Spécifie la durée, en secondes, pendant laquelle une session reste active dans Excel dans un navigateur en l’absence d’activité de l’utilisateur. Les valeurs valides sont les suivantes :

• -1 La session n’expire jamais.
• 0 La session expire à la fin d’une seule requête.
• 1 à 2073600, la session reste active entre 1 seconde et 24 jours.

La valeur par défaut est 450.

Propriétés du paramètre

Jeux de paramètres

-ExcelUdfsAllowed

Active les fonctions définies par l’utilisateur pour Excel dans un navigateur. La valeur par défaut est False.

Propriétés du paramètre

Jeux de paramètres

-ExcelUnusedObjectAgeMax

Durée maximale (en minutes) pendant laquelle les objets inactifs sont conservés dans la mémoire cache. Les objets inactifs sont des objets qui ne sont pas utilisés dans une session.

Valeurs valides :

• -1 (pas de maximum)
• 1 à 34560 (24 jours).

La valeur par défaut est -1.

Propriétés du paramètre

Jeux de paramètres

-ExcelUseEffectiveUserName

Active l’utilisation du paramètre Analysis Services EffectiveUserName avec Excel dans un navigateur. La valeur par défaut est False.

Propriétés du paramètre

Jeux de paramètres

-ExcelWarnOnDataRefresh

Désactive ou active la boîte de dialogue d’avertissement qui s’affiche lorsque les données sont actualisées dans Excel dans un navigateur.

Propriétés du paramètre

Jeux de paramètres

-ExcelWorkbookSizeMax

Spécifie la taille maximale, en mégaoctets, d’un classeur qu’un utilisateur peut charger.

Le type doit être une valeur entière comprise entre 1 et 2000. La valeur par défaut est 10.

Propriétés du paramètre

Jeux de paramètres

-ExternalURL

Spécifie la racine d’URL que les clients utilisent pour accéder à la batterie de Office Online Server à partir d’Internet. Dans le cas d’une batterie de serveurs multiserveurs Office Online Server à charge équilibrée, l’URL externe est liée à l’adresse IP de l’équilibreur de charge externe.

Une batterie de Office Online Server nécessite au moins une URL, qui est définie à l’aide de ExternalURL ou InternalURL. Vous pouvez également définir à la fois une URL interne et une URL externe.

Propriétés du paramètre

Jeux de paramètres

-FarmOU

Spécifie le nom de l’unité d’organisation Active Directory dont les serveurs doivent être membres pour rejoindre la batterie de Office Online Server. Utilisez ce paramètre pour empêcher les serveurs non autorisés (c’est-à-dire les serveurs qui ne sont pas dans l’unité d’organisation) de joindre une batterie de Office Online Server.

Propriétés du paramètre

Jeux de paramètres

-Force

Fait disparaître toutes les invites utilisateur en répondant « Oui ».

Propriétés du paramètre

Jeux de paramètres

-InternalURL

Spécifie la racine de l’URL que les clients doivent utiliser pour accéder à la batterie de Office Online Server à partir de l’intranet.

Une batterie de Office Online Server nécessite au moins une URL. Cette dernière est définie avec soit ExternalURL, soit InternalURL. Vous pouvez également définir à la fois une URL interne et une URL externe.

Propriétés du paramètre

Jeux de paramètres

-LogLocation

Spécifie l'emplacement sur l'ordinateur local dans lequel les journaux d'activité sont stockés.

L'emplacement s'applique pour chaque serveur inclus dans la batterie et n'est pas personnalisable par serveur. L’emplacement par défaut est %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS\.

Veillez à prévoir suffisamment d'espace disque sur le lecteur où sont stockés les journaux.

Vous devez redémarrer chaque serveur de la batterie pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-LogRetentionInDays

Spécifie le nombre de jours pendant lesquels les entrées de journal sont stockées. Les entrées de journal antérieures à la date configurée sont tronquées.

Le type doit être une valeur entière comprise entre 0 et 365. La valeur par défaut est 7 jours.

Vous devez redémarrer chaque serveur de la batterie pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-LogVerbosity

Spécifie la quantité d'informations stockées dans les fichiers journaux de suivi. Les valeurs sont les suivantes :

• VerboseEX : permet d'écrire un niveau de détails bas dans le fichier journal de suivi. Utile pour les suivis pouvant atteindre de gros volumes.
• Verbose : permet d'écrire un niveau de détails bas dans le fichier journal de suivi.
• Medium : permet d'écrire un niveau de détails moyen dans le fichier journal de suivi.
• High : permet d'écrire un niveau de détails élevé dans le fichier journal de suivi.
• Monitorable : permet d'écrire des suivis qui représentent un chemin d'accès à un code inhabituel et des actions à surveiller.
• Unexpected : permet d'écrire des suivis qui représentent un chemin d'accès à un code inattendu et des actions à surveiller.
• None : permet de n'écrire aucune information de suivi dans le fichier journal de suivi.

Le fait de laisser le paramètre LogVerbosity configuré à un niveau bas pendant longtemps a un impact négatif sur les performances.

Vous devez redémarrer chaque serveur de la batterie pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-MaxMemoryCacheSizeInMB

Spécifie la quantité maximale de mémoire (en Mo) que le cache de rendu peut utiliser.

Le type doit être une valeur entière comprise dans la plage 0 à tout entier positif. La taille par défaut s'élève à 1 024 Mo.

Propriétés du paramètre

Jeux de paramètres

-MaxTranslationCharacterCount

Spécifie le nombre maximal de caractères d'un document à traduire.

Le type doit être une valeur entière. Il peut s'agir de la valeur 0 pour indiquer l'absence de limite ou d'une valeur comprise entre 2 000 et 2 000 000. La valeur par défaut est 125 000.

Propriétés du paramètre

Jeux de paramètres

-OpenFromUncEnabled

Active ou désactive la possibilité d'utiliser des visionneuses en ligne pour afficher des fichiers Office à partir d'un chemin d'accès UNC.

Vous devez d'abord affecter la valeur True à OpenFromUrlEnabled pour permettre aux visionneuses en ligne d'afficher les fichiers situés dans les chemins d'accès UNC.

Propriétés du paramètre

Jeux de paramètres

-OpenFromUrlEnabled

Active ou désactive la possibilité d’utiliser les visionneuses en ligne pour afficher les fichiers Office à partir d’une URL ou d’un chemin UNC.

Propriétés du paramètre

Jeux de paramètres

-OpenFromUrlThrottlingEnabled

Limite le nombre de requêtes d'ouverture depuis une URL à partir d'un serveur donné pendant une période spécifique. Les valeurs de limitation par défaut, qui ne sont pas configurables, veillent à ce qu’une batterie de Office Online Server ne submerge pas un seul serveur avec des demandes d’affichage du contenu dans les visionneuses en ligne.

Propriétés du paramètre

Jeux de paramètres

-PicturePasteDisabled

Désactive la possibilité pour les utilisateurs de coller des images d’une page web dans Office dans un navigateur. La valeur par défaut est False. Si OpenFromURLEnabled a la valeur True et PicturePasteDisabled n’est pas défini ou défini sur False, les utilisateurs peuvent coller des images dans Office dans un navigateur.

Propriétés du paramètre

Jeux de paramètres

-Proxy

Spécifie l'URL du serveur proxy configuré pour autoriser les requêtes HTTP faites à des sites externes. Généralement configuré conjointement aux paramètres ClipartEnabled et TranslationEnabled.

Propriétés du paramètre

Jeux de paramètres

-RecycleActiveProcessCount

Spécifie le nombre de fichiers qu’un seul processus Word ou PowerPoint peut afficher avant le recyclage du processus. Le type doit être une valeur entière comprise entre 1 et 1 000. La valeur par défaut est 5.

Vous devez redémarrer chaque serveur de la batterie pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-RemovePersonalInformationFromLogs

Fournit un nettoyage optimal des informations personnelles des journaux d’Office Online Server et remplace les valeurs par un hachage SHA256. Les informations potentiellement effacées peuvent être les suivantes :

• Noms des documents et URL
• Adresses IP
• Adresses de messagerie
• Noms d'utilisateur

La valeur par défaut est False. Notez que l’activation de ce paramètre ne garantit pas que les informations personnelles ne seront pas consignées dans les journaux Office Online Server.

Propriétés du paramètre

Jeux de paramètres

-RenderingLocalCacheLocation

Spécifie l’emplacement du cache temporaire à utiliser par les services d’affichage Word et PowerPoint.

L’emplacement par défaut est %programdata%\Microsoft\OfficeWebApps\Working\waccache\.

Propriétés du paramètre

Jeux de paramètres

-S2SCertificateName

Nom convivial du certificat à utiliser pour l’authentification de serveur à serveur avec SharePoint Server.

Propriétés du paramètre

Jeux de paramètres

-SSLOffloaded

Indique aux serveurs de la batterie de Office Online Server que SSL est déchargé vers l’équilibreur de charge. Lorsque le paramètre SSLOffloaded est activé, les applications web sont liées au port 80 (HTTP) sur le serveur local. Cependant, le langage HTML qui référence d'autres ressources, comme des styles CSS ou des images, utilise des URL HTTPS pour ces références.

Vous devez redémarrer chaque serveur de la batterie pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-TranslationEnabled

Active la prise en charge de la traduction automatique des documents à l'aide de Microsoft Translator, un service en ligne qui permet de traduire du texte d'une langue vers une autre. Le fichier traduit est affiché dans Word. Étant donné que Microsoft Translator est un service en ligne, vous devez activer la communication entre le serveur et le web directement ou à l'aide d'un proxy que vous spécifiez à l'aide du paramètre Proxy.

Microsoft Translator peut collecter des données afin d'améliorer la qualité des traductions.

Propriétés du paramètre

Jeux de paramètres

-TranslationServiceAddress

Spécifie l'URL du serveur de traduction auquel les demandes de traduction sont envoyées. La valeur par défaut correspond au service en ligne Microsoft Translator. En règle générale, vous n'êtes pas censé utiliser ce paramètre, sauf si vous devez changer de service de traduction.

Vous devez redémarrer tous les serveurs de la batterie de Office Online Server pour que cette modification prenne effet.

Propriétés du paramètre

Jeux de paramètres

-TranslationServiceAppId

Spécifie l'ID d'application du service de traduction. La valeur par défaut est l’ID d’application publique pour Office dans un navigateur. En règle générale, vous n'êtes pas censé utiliser ce paramètre, sauf si vous avez négocié des services supplémentaires auprès de Microsoft Translator et qu'un ID d'application privé vous a été attribué.

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter.

Propriétés du paramètre

Jeux de paramètres