Set-OfficeWebAppsFarm

Syntax

Default (Standardwert)

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]

Beschreibung

Beispiele

BEISPIEL 1

Set-OfficeWebAppsFarm -ClipartEnabled:$true

BEISPIEL 2

Set-OfficeWebAppsFarm -EditingEnabled:$true

BEISPIEL 3

Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false

Parameter

-AllowCEIP

Aktiviert die Berichterstellung für das Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Program, CEIP) auf allen Servern in der Office Online Server Farm.

Sie müssen jeden Server in der Office Online Server Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-AllowHttp

Gibt an, dass IIS-Websites an Port 80 für den HTTP-Zugriff bereitgestellt werden sollen. Verwenden Sie AllowHTTP nur in Umgebungen, in denen alle Computer IPSec (vollständige Verschlüsselung) anfordern, oder in Testumgebungen ohne sensible Dateien.

Wird bei Aktivierung von SSLOffloaded automatisch aktiviert.

Sie müssen alle Server in der Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-AllowHttpSecureStoreConnections

Gibt an, dass Verbindungen für einmaliges Anmelden durch Verwendung von Verbindungen ohne SSL (z. B. HTTP) hergestellt werden können. Der Standardwert ist False.

Verwenden Sie AllowHTTPSecureStoreConnections nur in Umgebungen, in denen für alle Computer IPsec (vollständige Verschlüsselung) erforderlich ist, oder in Testumgebungen, die keine vertraulichen Daten enthalten.

Parametereigenschaften

Parametersätze

-AllowOutboundHttp

Lässt ausgehende HTTP-Verbindungen von Office Online Server zu.

Parametereigenschaften

Parametersätze

-CacheLocation

Gibt den Speicherort des globalen Datenträgercaches an, der zum Speichern gerenderter Bilddateien dient. Der Standardspeicherort ist %programdata%\Microsoft\OfficeWebApps\Working\d\.

Parametereigenschaften

Parametersätze

-CacheSizeInGB

Gibt die maximale Größe des globalen Datenträgercaches in GB an. Der Typ muss ein ganzzahliger Wert im Bereich von 0 bis zu einer beliebigen ganzen Zahl sein. Der Standardwert ist 15 GB.

Parametereigenschaften

Parametersätze

-CertificateName

Gibt den Anzeigenamen des Zertifikats an, das Office Online Server zum Erstellen von HTTPS-Bindungen verwendet.

Wenn das angegebene Zertifikat nicht gefunden wird oder abgelaufen ist oder der angegebene Wert mehreren Zertifikaten zugeordnet ist, wird ein Fehler protokolliert. Die Farm wird nicht erstellt.

Dieser Wert wird auf jedem Server verwendet, der der Office Online Server Farm beitritt. Deshalb müssen alle Server in der Farm über ein Zertifikat mit diesem Anzeigenamen verfügen.

Sie müssen den Parameter CertificateName nicht angeben, wenn Sie entweder den Parameter AllowHttp oder SSLOffloaded verwenden.

Sie müssen alle Server in der Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-ClipartEnabled

Ermöglicht die Unterstützung für das Einfügen von ClipArt aus Office.com in Office-Dokumente. Für dieses Feature ist eine Kommunikation zwischen dem Server und dem Internet erforderlich, die entweder direkt oder über einen Proxy erfolgt, den Sie mit dem Proxy-Parameter angeben.

Parametereigenschaften

Parametersätze

-Confirm

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird.

Parametereigenschaften

Parametersätze

-DocumentInfoCacheSize

Gibt die maximale Anzahl von Dokumentkonvertierungsdatensätzen an, die in einem Arbeitsspeichercache gespeichert werden.

Der Standardwert ist 5000.

Parametereigenschaften

Parametersätze

-EditingEnabled

Aktiviert die Unterstützung der Bearbeitung im Browser. Der Standardwert ist False. Legen Sie True nur fest, wenn Sie über eine entsprechende Lizenz zum Verwenden der Bearbeitungsfunktion verfügen.

Parametereigenschaften

Parametersätze

-ExcelAbortOnRefreshOnOpenFail

Verhindert das Laden einer Arbeitsmappe, wenn bei der Datenaktualisierung ein Fehler auftritt. Dadurch wird verhindert, dass Benutzern veraltete Informationen oder möglicherweise Informationen, auf die sie keinen Zugriff haben sollten, angezeigt werden.

Parametereigenschaften

Parametersätze

-ExcelAllowExternalData

Ermöglicht die Aktualisierung unterstützter externer Daten in Excel-Arbeitsmappen in einem Browser, in dem Arbeitsmappen Verbindungen mit externen Daten enthalten. Der Standardwert lautet "True".

Parametereigenschaften

Parametersätze

-ExcelAutomaticVolatileFunctionCacheLifeTime

Gibt die maximale Zeit in Sekunden an, die ein berechneter Wert für eine veränderliche Funktion für automatische Neuberechnungen zwischengespeichert wird.

• -1: Einmalige Berechnung beim Laden der Arbeitsmappe.
• 0: stets neu berechnen
• 1 bis 2073600: Von einer Sekunde bis zu 24 Tagen zwischenspeichern

Parametereigenschaften

Parametersätze

-ExcelCachingUnusedFiles

Aktiviert das Zwischenspeichern von Dateien, die nicht mehr von Web Excel-Sitzungen verwendet werden.

Parametereigenschaften

Parametersätze

-ExcelChartAndImageSizeMax

Gibt die maximale Größe eines Diagramms oder Bilds in Megabyte an, das von Excel in einem Browser geöffnet werden kann. Der Wert muss eine ganze Zahl größer 0 sein.

Parametereigenschaften

Parametersätze

-ExcelConcurrentDataRequestsPerSessionMax

Gibt die maximale Anzahl gleichzeitiger externer Datenanforderungen an, die je Sitzung zulässig sind. Wenn eine Sitzung mehr als diese Anzahl Anforderungen ausgeben muss, werden weitere Anforderungen in die Warteschlange eingestellt.

Parametereigenschaften

Parametersätze

-ExcelConnectionLifetime

Gibt die Dauer externer Datenverbindungen für Excel in einem Browser in Sekunden an. Der Standardwert ist 1800 Sekunden.

Parametereigenschaften

Parametersätze

-ExcelDefaultWorkbookCalcMode

PARAMETERWERT: File | Manual | Auto | AutoDataTables

Parametereigenschaften

Parametersätze

-ExcelExternalDataCacheLifetime

Gibt die Dauer der Lebensdauer des externen Datencaches in Excel in einem Browser in Sekunden an. Die Standardeinstellung ist 300 Sekunden.

Parametereigenschaften

Parametersätze

-ExcelMemoryCacheThreshold

Der Prozentsatz der maximalen Anzahl privater Bytes, der inaktiven Objekten zugewiesen werden kann. Wenn der Schwellenwert für den Arbeitsspeichercache überschritten wird, werden zwischengespeicherte Objekte, die aktuell nicht verwendet werden, freigegeben. Gültige Werte: 0 (deaktiviert das Zwischenspeichern inaktiver Objekte); von 1 bis 95.

Parametereigenschaften

Parametersätze

-ExcelPrivateBytesMax

Gibt die maximale Anzahl privater Bytes in Megabytes an, die von Excel in einem Browser verwendet werden. Bei Festlegung auf -1 belegt die maximale Anzahl privater Bytes 50 % des physischen Arbeitsspeichers des Computers.

Der Typ muss -1 oder eine beliebige positive ganze Zahl sein. Der Standardwert ist -1.

Sie müssen alle Server in der Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-ExcelRequestDurationMax

Gibt die maximale Dauer in Sekunden für eine einzelne Anforderung in einer Sitzung an. Nach dem Ablaufen dieses Zeitraums tritt ein Timeout der Anforderung auf.

Der Typ muss -1 (keine Einschränkung) oder eine ganze Zahl im Bereich von 1 bis 2073600 sein. Der Standardwert ist 300.

Parametereigenschaften

Parametersätze

-ExcelRestExternalDataEnabled

Lässt Anfragen von der REST-API zu, externe Datenverbindungen zu aktualisieren. Die Einstellung hat keine Auswirkungen, wenn "Externe Daten zulassen" auf None festgelegt ist. Kontrollkästchen Bool. Der Standardwert ist False.

Parametereigenschaften

Parametersätze

-ExcelSessionTimeout

Gibt die Zeit in Sekunden an, zu der eine Sitzung in Excel in einem Browser aktiv bleibt, wenn keine Benutzeraktivität vorhanden ist. Zu den gültigen Werten gehören die folgenden:

• -1 Sitzung läuft nie ab.
• 0 Die Sitzung läuft am Ende einer einzelnen Anforderung ab.
• 1 bis 2073600 Sitzung bleibt 1 Sekunde bis 24 Tage aktiv.

Der Standardwert ist 450.

Parametereigenschaften

Parametersätze

-ExcelUdfsAllowed

Aktiviert benutzerdefinierte Funktionen für Excel in einem Browser. Der Standardwert ist False.

Parametereigenschaften

Parametersätze

-ExcelUnusedObjectAgeMax

Die maximale Zeit (in Minuten), die inaktive Objekte im Arbeitsspeichercache bleiben. Inaktive Objekte sind Objekte, die nicht in einer Sitzung verwendet werden.

Gültige Werte:

• -1 (kein Maximum)
• 1 bis 34560 (24 Tage).

Der Standardwert ist -1.

Parametereigenschaften

Parametersätze

-ExcelUseEffectiveUserName

Ermöglicht die Verwendung des Analysis Services-Parameters EffectiveUserName mit Excel in einem Browser. Der Standardwert ist False.

Parametereigenschaften

Parametersätze

-ExcelWarnOnDataRefresh

Deaktiviert oder aktiviert das Warnungsdialogfeld, das angezeigt wird, wenn Daten in Excel in einem Browser aktualisiert werden.

Parametereigenschaften

Parametersätze

-ExcelWorkbookSizeMax

Gibt die maximale Größe einer zu ladenden Arbeitsmappe in MB an.

Der Typ muss ein ganzzahliger Wert im Bereich von 1 bis 2000 sein. Der Standardwert ist 10.

Parametereigenschaften

Parametersätze

-ExternalURL

Gibt den URL-Stamm an, den Clients verwenden, um über das Internet auf die Office Online Server Farm zuzugreifen. Bei einer Farm mit Lastenausgleich mit mehreren Servern Office Online Server wird die externe URL an die IP-Adresse des externen Lastenausgleichs gebunden.

Eine Office Online Server Farm erfordert mindestens eine URL, die entweder externalURL oder InternalURL verwendet. Sie können auch sowohl interne als auch externe URLs festlegen.

Parametereigenschaften

Parametersätze

-FarmOU

Gibt den Namen der Active Directory-Organisationseinheit (OE) an, in der Server Mitglied sein müssen, um der Office Online Server Farm beizutreten. Verwenden Sie diesen Parameter, um zu verhindern, dass nicht autorisierte Server (d. h. Server, die sich nicht in der Organisationseinheit befinden) einer Office Online Server Farm beitreten.

Parametereigenschaften

Parametersätze

-Force

Unterdrückt sämtliche Eingabeaufforderungen, indem mit "Ja" geantwortet wird.

Parametereigenschaften

Parametersätze

-InternalURL

Gibt den URL-Stamm an, den Clients verwenden müssen, um über das Intranet auf die Office Online Server Farm zuzugreifen.

Eine Office Online Server Farm erfordert mindestens eine URL. Sie wird entweder mit ExternalURL oder InternalURL festgelegt. Sie können auch sowohl interne als auch externe URLs festlegen.

Parametereigenschaften

Parametersätze

-LogLocation

Gibt den Speicherort der Aktivitätsprotokolle auf dem lokalen Computer an.

Der Speicherort gilt für alle Server in der Farm und kann nicht serverbezogen angepasst werden. Der Standardspeicherort ist %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS\.

Stellen Sie auf dem Laufwerk, auf dem die Protokolle gespeichert werden, genügend Festplattenspeicher zur Verfügung.

Sie müssen alle Server in der Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-LogRetentionInDays

Gibt die Anzahl der Tage an, die Protokolleinträge gespeichert werden sollen. Protokolleinträge, die älter als das konfigurierte Datum sind, werden entfernt.

Der Typ muss ein ganzzahliger Wert im Bereich von 0 bis 365 sein. Die Standardeinstellung beträgt 7 Tage.

Sie müssen alle Server in der Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-LogVerbosity

Gibt an, wie viele Informationen in den Ablaufprotokolldateien gespeichert werden. Die Werte sind wie folgt:

• VerboseEX schreibt Details auf niedriger Ebene in die Ablaufverfolgungsprotokolldatei. Nützlich für Ablaufverfolgungen, die wahrscheinlich ein hohes Volumen aufweisen.
• Verbose. Schreibt untergeordnete Details in die Ablaufprotokolldatei.
• Medium. Schreibt als mittelwichtig eingestufte Details in die Ablaufprotokolldatei.
• High. Schreibt als wichtig eingestufte Details in die Ablaufprotokolldatei.
• Monitorable. Schreibt Ablaufverfolgungen, die einen ungewöhnlichen Codepfad darstellen, und Aktionen, die überwacht werden sollten.
• Unexpected. Schreibt Ablaufverfolgungen, die einen unerwarteten Codepfad darstellen, und Aktionen, die überwacht werden sollten.
• None. Schreibt keine Ablaufinformationen in die Ablaufprotokolldatei.

Das Belassen von LogVerbosity auf einer niedrigen Stufe über einen längeren Zeitraum kann sich negativ auf die Systemleistung auswirken.

Sie müssen alle Server in der Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-MaxMemoryCacheSizeInMB

Gibt die maximale Speichergröße (in MB) an, die vom Rendercache verwendet werden darf.

Der Typ muss ein ganzzahliger Wert im Bereich von 0 bis zu einer beliebigen positiven Zahl sein. Der Standardwert ist 1024 MB.

Parametereigenschaften

Parametersätze

-MaxTranslationCharacterCount

Gibt die maximale Anzahl der Zeichen an, die ein Dokument enthalten kann, um übersetzt werden zu können.

Der Typ muss ein ganzzahliger Wert sein. Der Wert kann auf 0 festgelegt werden, um keinen Grenzwert oder einen Wert von 2000 bis 2.000.000 anzugeben. Der Standardwert ist 125.000.

Parametereigenschaften

Parametersätze

-OpenFromUncEnabled

Aktiviert bzw. deaktiviert die Funktion, mit Onlineviewern Office-Dateien über einen UNC-Pfad anzuzeigen.

Legen Sie für "OpenFromUrlEnabled" zunächst "True" fest, um die Anzeige von Dateien über UNC-Pfade mit Onlineviewern zuzulassen.

Parametereigenschaften

Parametersätze

-OpenFromUrlEnabled

Aktiviert oder deaktiviert die Möglichkeit, Mithilfe von Online-Viewern Office-Dateien über eine URL oder einen UNC-Pfad anzuzeigen.

Parametereigenschaften

Parametersätze

-OpenFromUrlThrottlingEnabled

Begrenzt die Anzahl der Anforderungen vom Typ "Aus URL öffnen" von einem angegebenen Server in einem Zeitraum. Die nicht konfigurierbaren Standarddrosselungswerte stellen sicher, dass eine Office Online Server Farm einen einzelnen Server nicht mit Anforderungen überfordert, dass Inhalte in den Online-Viewern angezeigt werden sollen.

Parametereigenschaften

Parametersätze

-PicturePasteDisabled

Deaktiviert die Möglichkeit für Benutzer, Bilder von einer Webseite in office in einem Browser einzufügen. Der Standardwert ist False. Wenn OpenFromURLEnabled auf True und PicturePasteDisabled nicht oder nicht auf False festgelegt ist, können Benutzer Bilder in einem Browser in Office einfügen.

Parametereigenschaften

Parametersätze

-Proxy

Gibt die URL des Proxyservers an, der dafür konfiguriert ist, dass HTTP-Anforderungen an externe Websites erfolgreich sind. Wird zumeist gemeinsam mit den Parametern ClipartEnabled und TranslationEnabled konfiguriert.

Parametereigenschaften

Parametersätze

-RecycleActiveProcessCount

Gibt die Anzahl der Dateien an, die ein einzelner Word- oder PowerPoint-Prozess rendern kann, bevor der Prozess wiederverwendet wird. Der Typ muss ein ganzzahliger Wert im Bereich von 1 bis 1000 sein. Der Standardwert ist 5.

Sie müssen alle Server in der Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-RemovePersonalInformationFromLogs

Bietet ein Best-Effort-Scrub von persönlichen Informationen aus Office Online Server Protokollen und ersetzt Werte durch einen SHA256-Hash. Folgende Informationen werden möglicherweise entfernt:

• Dokumentnamen und URLs
• IP-Adressen
• E-Mail-Adressen
• Benutzernamen

Der Standardwert ist False. Beachten Sie, dass die Aktivierung dieses Parameters nicht garantiert, dass personenbezogene Informationen nicht in den Office Online Server Protokollen protokolliert werden.

Parametereigenschaften

Parametersätze

-RenderingLocalCacheLocation

Gibt den Speicherort des temporären Caches an, der von den Word und PowerPoint-Anzeigediensten verwendet werden soll.

Der Standardspeicherort ist %programdata%\Microsoft\OfficeWebApps\Working\waccache\.

Parametereigenschaften

Parametersätze

-S2SCertificateName

Der Anzeigename des Zertifikats, das für die Server-zu-Server-Authentifizierung mit SharePoint Server verwendet werden soll.

Parametereigenschaften

Parametersätze

-SSLOffloaded

Gibt den Servern in der Office Online Server farm an, dass SSL auf den Lastenausgleich ausgelagert wird. Bei Aktivierung von SSLOffloaded werden Webanwendungen an Port 80 (HTTP) auf dem lokalen Server gebunden. Für HTML, die auf andere Ressourcen verweist, z. B. CSS oder Bilder, werden allerdings HTTPS-URLs für diese Verweise verwendet.

Sie müssen alle Server in der Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-TranslationEnabled

Aktiviert Unterstützung für die automatische Dokumentübersetzung mit Microsoft Translator, einem Onlinedienst, der Text zwischen zwei Sprachen übersetzt. Die übersetzte Datei wird in Word angezeigt. Da Microsoft Translator ein Onlinedienst ist, müssen Sie die Kommunikation zwischen dem Server und dem Internet entweder direkt oder über einen Proxy aktivieren, den Sie mit dem Proxy-Parameter angeben.

Microsoft Translator sammelt ggf. Daten zur Verbesserung der Qualität von Übersetzungen.

Parametereigenschaften

Parametersätze

-TranslationServiceAddress

Gibt die URL des Übersetzungsservers an, an den Übersetzungsanforderungen gesendet werden. Standardmäßig ist der Microsoft Translator-Onlinedienst angegeben. In der Regel wird dieser Parameter nicht verwendet, es sei denn, Sie müssen die Übersetzungsdienste ändern.

Sie müssen jeden Server in der Office Online Server Farm neu starten, damit diese Änderung wirksam wird.

Parametereigenschaften

Parametersätze

-TranslationServiceAppId

Gibt die Anwendungs-ID für den Übersetzungsdienst an. Die Standardeinstellung ist die öffentliche Anwendungs-ID für Office in einem Browser. In der Regel wird dieser Parameter nicht verwendet, es sei denn, Sie haben mit Microsoft Translator zusätzliche Dienste ausgehandelt und eine private Anwendungs-ID erhalten.

Parametereigenschaften

Parametersätze

-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen.

Parametereigenschaften

Parametersätze