Set-SPExcelServiceApplication
Legt globale Eigenschaften für eine Excel Services-Anwendung fest.
Syntax
Set-SPExcelServiceApplication
[[-Identity] <SPExcelServiceApplicationPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CachingOfUnusedFilesEnable]
[-Confirm]
[-CrossDomainAccessAllowed]
[-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>] Set-SPExcelServiceApplication
[[-Identity] <SPExcelServiceApplicationPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CachingOfUnusedFilesEnable]
[-Confirm]
[-CrossDomainAccessAllowed]
[-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>] Beschreibung
Das Set-ExcelServiceApplication Cmdlet ändert die globalen Laufzeiteigenschaften für Excel Services Application.
Änderungen an Eigenschaften, die mit diesem Cmdlet vorgenommen werden, wirken sich auf alle Computer in der Farm aus, auf denen eine Instanz der angegebenen Excel Services Application-Webdienstanwendung ausgeführt wird.
Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.
Beispiele
--------------BEISPIEL 1--------------
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -SessionsPerUserMax 10In diesem Beispiel wird die Excel Services-Anwendung so festgelegt, dass jeder Benutzer nicht mehr als 10 Sitzungen gleichzeitig auf einem Back-End-Anwendungsserver öffnen kann, auf dem Excel Services Application ausgeführt wird.
--------------BEISPIEL 2--------------
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1In diesem Beispiel wird die maximale Anzahl privater Bytes an Arbeitsspeicher auf dem Computer auf den Wert -1 festgelegt, was angibt, dass Excel Services Anwendung 50 Prozent der verfügbaren Speicherressourcen beansprucht.
Parameter
-AssignmentCollection
Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.
Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten.
Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.
| 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
Gibt an, dass Dateien, die nicht mehr von Excel Services Application verwendet werden, zur späteren Verwendung im Cache verbleiben können. Der Standardwert ist True, wenn der Parameter für den Befehl nicht angegeben wird.
| 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
Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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
Gibt an, dass vertrauenswürdige Arbeitsmappen- und Datenverbindungsdateien von Webparts oder von Seiten, die sich in anderen HTTP-Domänen befinden, abgerufen und gerendert werden können.
| 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
Erfordert, dass die Verschlüsselung zwischen dem Endbenutzer und dem Server verwendet wird, auf dem Excel Services Anwendung ausgeführt wird. Der Gültigkeitsbereich für diese Einstellung ist der logische Server. Der Standardwert ist None.
Der Typ muss einer der folgenden Werte sein: None oder 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
Gibt die maximale Anzahl Sekunden an, die eine externe Datenverbindung im Verbindungspool geöffnet bleiben kann.
Gültige Werte sind:
-1 Nie wiederverwenden
1 bis 2073600 Bleiben Sie 1 Sekunde bis 24 Tage aktiv.
Der Standardwert ist 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
Gibt die Authentifizierungsmethode an, die Excel Services Application zum Abrufen von Dateien verwendet. UseFileAccessAccount gibt an, dass alle Arbeitsmappen immer die Anmeldeinformationen des Dienstkontos verwenden, das Excel Services Application ausgeführt wird. UseImpersonation gibt an, dass Excel Services Application die Arbeitsmappendateien als der Benutzer abruft, der die Anforderung stellt. Der Standardwert ist UseImpersonation.
Der Typ muss einer der folgenden Werte sein: UseImpersonation oder 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 |
-Identity
Gibt das zu aktualisierende SPExcelServiceApplication-Objekt an.
Der Typ muss eine gültige GUID im Format 12345678-90ab-cdef-1234-567890bcdefgh sein; ein gültiger Name einer Excel Services Application-Webdienstanwendung in der Farm (z. B. MyExcelService1) oder eine Instanz eines gültigen SPExcelServiceApplication-Objekts.
| Type: | SPExcelServiceApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-LoadBalancingScheme
Gibt das Lastenausgleichsschema an, das von der Excel Services Application Web Service-Anwendung verwendet wird, um Anforderungen an verschiedene Back-End-Excel Services Application-Computer zu senden. Der Standardwert ist WorkbookURL.
Der Typ muss einer der folgenden Werte sein: RoundRobin, Lokal oder 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
Gibt den Prozentsatz der maximalen Anzahl privater Bytes an, die inaktiven Objekten zugewiesen werden können. Wenn der Schwellenwert für den Arbeitsspeichercache überschritten wird, werden zwischengespeicherte Objekte, die aktuell nicht verwendet werden, freigegeben. Durch das Festlegen dieses Werts auf 0 wird die Zwischenspeicherung inaktiver Objekte deaktiviert. Der Standardwert ist 90.
Der Typ muss eine ganze Zahl im Bereich zwischen 0 und 95 sein.
| 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 |
-PrivateBytesMax
Gibt die maximale Anzahl privater Bytes in Megabyte an, die von Excel Services Application verwendet werden. Bei der Einstellung auf -1 entspricht die maximale Anzahl privater Bytes standardmäßig 50 Prozent des physischen Arbeitsspeichers auf dem Computer. Gültige Werte sind -1 – keine Einschränkung – und positive ganze Zahlen beliebiger Größe. Der Standardwert ist -1.
Der Typ muss -1 oder eine beliebige positive ganze Zahl sein.
| 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
Gibt die maximale Anzahl der für einen Benutzer zulässigen Sitzungen an. Wenn ein Benutzer dieses Maximum erreicht, wird die älteste Sitzung gelöscht, wenn eine neue Sitzung gestartet wird. Gültige Werte sind -1 – keine Einschränkung – und positive ganze Zahlen beliebiger Größe. Der Standardwert ist 25.
Der Typ muss -1 oder eine beliebige positive ganze Zahl sein.
| 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
Gibt die maximale Anzahl anonymer Sitzungen an, die pro Websitesammlung zulässig sind. Der Wert 0 gibt an, dass keine anonymen Sitzungen zulässig sind. Die gültigen Werte sind -1 – keine Einschränkung – 0 wenn die Einschränkung deaktiviert werden soll, oder eine beliebige positive ganze Zahl. Der Standardwert ist 25.
Der Typ muss -1, 0 oder eine beliebige positive ganze Zahl sein.
| 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
Beendet Excel Services Anwendung, wenn dabei eine Zugriffsverletzung auftritt.
| 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
Gibt an, dass das Laden aller Dateien, die aus der Websitesammlung dieser Arbeitsmappe stammen, für den angegebenen Zeitraum (in Sekunden) blockiert wird, wenn eine Arbeitsmappe einen Zugriffsfehler für Excel Services Application verursacht. Die bestehenden Sitzungen für Dateien aus dieser Websitesammlung sind davon nicht betroffen. Die gültigen Werte sind 0 – zum Deaktivieren der Einstellung – und der Bereich von 1 bis 2073600 Sekunden (24 Tagen). Der Standardwert ist 0.
Der Typ muss ein ganzzahliger Wert im Bereich von 0 bis 2073600 sein.
| 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
Gibt an, dass die Anwendungs-ID, die verwendet wird, um die Anmeldeinformationen des unbeaufsichtigten Dienstkontos aus dem sicheren Speicherdienst nachzuschlagen, der durch den Parameter UnattendedAccountSecureServiceAppName angegeben wird. Der sichere Speicherdienst wird kontaktiert, wenn dieser Parameter festgelegt ist und bestimmte Fehlerfälle auftreten. Gültige Werte sind alphanumerische Zeichenfolgen mit einer maximalen Größe von 256 Zeichen. Der Standardwert ist eine leere Zeichenfolge.
Der Typ muss eine gültige Zeichenfolge alphanumerischer Zeichen sein, z. B. UnattendedServiceAccountID.
Das unbeaufsichtigte Konto ist ein einzelnes Konto, das von allen Arbeitsmappen zum Aktualisieren von Daten verwendet werden kann. Ein unbeaufsichtigtes Konto ist erforderlich, wenn in Arbeitsmappenverbindungen für de Authentifizierung Ohne angegeben ist oder für die Aktualisierung von Daten nicht von Windows stammende Anmeldeinformationen verwendet werden.
| 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
Das unbeaufsichtigte Dienstkonto ist ein einzelnes Konto, das alle Arbeitsmappen zum Aktualisieren von Daten verwenden können. Dieses Konto ist erforderlich, um Daten zu aktualisieren, wenn Arbeitsmappenverbindungen "Verwenden des unbeaufsichtigten Dienstkontos" ohne Verwendung von Windows-Anmeldeinformationen angeben.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013 |
-UnusedObjectAgeMax
Gibt den maximalen Zeitraum in Minuten an, für den Objekte, die aktuell nicht in Sitzungen verwendet werden, im Arbeitsspeichercache erhalten bleiben. Gültige Werte sind -1 – keine Einschränkung – und positive ganze Zahlen im Bereich von 1 bis 34560 Minuten (24 Tagen). Der Standardwert ist -1.
Der Typ muss -1 oder eine ganze Zahl im Bereich von 1 bis 34560 sein.
| 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
Die UseEffectiveUserName-Eigenschaft ist eine Alternative zur Windows-Delegierung, um Benutzern den sicheren Zugriff auf Analysis Services-Daten zu ermöglichen.
Die Einstellung wirkt sich nur auf externe Datenverbindungen aus, die auf Analysis Services-Arbeitsmappenverbindungen mit der Authentifizierungseinstellung "Konto des authentifizierten Benutzers verwenden" basieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013 |
-WhatIf
Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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
Gibt den lokalen Dateisystemspeicherort des Caches an, der zum Speichern von Arbeitsmappen verwendet wird, die von Excel Services Application verwendet werden.
Wenn kein Wert angegeben wird, ist der Standardwert ein Unterverzeichnis im temporären Systemverzeichnis.
Der Typ muss ein gültiger Pfad in einem der folgenden Formate sein:
-- 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
Gibt die maximal zulässige Größe einer einzelnen Sitzung in MB an. Der Standardwert ist 0.
Der Typ muss eine positive ganze Zahl sein.
| 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 2013 |
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für