New-OfficeWebAppsFarm

Crée une batterie Office Online Server sur l'ordinateur local.

Syntax

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

L’applet de commande New-OfficeWebAppsFarm crée une batterie de Office Online Server sur l’ordinateur local. Vous exécutez cette applet de commande sur le premier serveur de la batterie de Office Online Server, puis vous ajoutez d’autres serveurs à la batterie à l’aide de l’applet de commande New-OfficeWebAppsMachine.

Exemples

------------------EXEMPLE 1---------------------

New-OfficeWebAppsFarm -ExternalUrl "https://office.contoso.com" -CertificateName "Office Server Cert" -EditingEnabled:$true

Cet exemple crée une batterie de Office Online Server sur le serveur local pour lequel la modification est activée pour Office dans un navigateur. Dans cet exemple, une seule URL est utilisée pour les utilisateurs internes et externes. La valeur Nom du certificat est le nom convivial du certificat tel qu’il apparaît dans le magasin de certificats de l’ordinateur.

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.

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

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

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

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

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

-AllowOutboundHttp

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

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

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

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

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

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

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

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

-ClipartEnabled

Active la prise en charge de l’insertion d’images Bing 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.

Le paramètre OpenFromUrlEnabled doit être défini sur True pour que les images Bing fonctionnent. La valeur par défaut est False.

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

-Confirm

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

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

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

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

-EditingEnabled

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

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

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

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

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

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

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

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

-ExcelCachingUnusedFiles

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

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

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

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

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

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

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

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

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.

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

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

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

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

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

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

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

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

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

-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 à 2073600Session reste actif pendant 1 seconde à 24 jours. La valeur par défaut est 450.

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

-ExcelUdfsAllowed

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

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

-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 (illimité) ; de 1 à 34560 (24 jours). La valeur par défaut est -1.

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

-ExcelUseEffectiveUserName

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

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

-ExcelWarnOnDataRefresh

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

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

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

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

-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 Office Online Server nécessite au moins une URL, définie à l’aide de ExternalURL ou InternalURL. Vous pouvez également définir à la fois une URL interne et une URL externe.

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

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

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

-Force

Supprime toutes les invites de l’utilisateur en répondant à Oui.

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

-InternalURL

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

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

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

-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 à laisser suffisamment d’espace disque sur le lecteur sur lequel les journaux sont stockés.

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

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

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

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

Laisser LogVerbosity à un niveau bas pendant une période prolongée aura un impact négatif sur les performances.

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

-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 est de 75 Mo.

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

-MaxTranslationCharacterCount

Spécifie la quantité maximale de caractères qu’un document peut avoir pour être traduit.

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.

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

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

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

-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. La valeur par défaut est False.

Vous devez définir ce paramètre sur True lorsque vous utilisez ClipartEnabled.

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

-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 de contenu dans les visionneuses en ligne.

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

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

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

-Proxy

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

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

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

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

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

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

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

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

-S2SCertificateName

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

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

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

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

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

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

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

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

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

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

-WhatIf

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

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