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 globale Laufzeiteigenschaften für Excel Services Anwendung. Ä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-Anwendungswebdienstanwendung 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 10

In diesem Beispiel wird die Excel Services-Anwendung so festgelegt, dass jeder Benutzer maximal 10 Sitzungen gleichzeitig auf einem Back-End-Anwendungsserver öffnen kann, auf dem Excel Services Anwendung ausgeführt wird.

--------------BEISPIEL 2--------------

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1

In diesem Beispiel wird die maximale Anzahl privater Bytes des Arbeitsspeichers auf dem Computer auf den Wert -1 festgelegt. Dies bedeutet, dass Excel Services Anwendung 50 Prozent der verfügbaren Speicherressourcen verbraucht.

Parameter

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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 Anwendung 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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-FileAccessMethod

Gibt die Authentifizierungsmethode an, die Excel Services Anwendung zum Abrufen von Dateien verwendet. UseFileAccessAccount gibt an, dass alle Arbeitsmappen immer die Anmeldeinformationen des Dienstkontos verwenden, das Excel Services Anwendung ausführt. UseImpersonation gibt an, dass Excel Services Application die Arbeitsmappendateien als 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Identity

Gibt das zu aktualisierenden 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 Anwendungswebdienstanwendung in der Farm (z. B. MyExcelService1) oder einer Instanz eines gültigen SPExcelServiceApplication-Objekts.

Type:SPExcelServiceApplicationPipeBind
Position:1
Default value:None
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 Anwendungswebdienstanwendung verwendet wird, um Anforderungen an verschiedene Back-End-Excel Services Anwendungscomputer 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-MemoryCacheThreshold

Specifies the percentage of the maximum private bytes that can be allocated to inactive objects. When the memory cache threshold is exceeded, cached objects that are not currently in use are released. Setting this value to 0 disables caching of inactive objects. The default value is 90.

Der Typ muss eine ganze Zahl im Bereich zwischen 0 und 95 sein.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-PrivateBytesMax

Gibt die maximalen privaten Bytes in Megabyte an, die von Excel Services Anwendung 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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-SiteCollectionAnonymousSessionsMax

Specifies the maximum number of anonymous sessions allowed per site collection. A value of 0 specifies that no anonymous sessions are allowed. Valid values include -1 for no limit, 0 to disable the setting, or any positive integer. The default value is 25.

Der Typ muss -1, 0 oder eine beliebige positive ganze Zahl sein.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-TerminateProcessOnAccessViolation

Beendet Excel Services Anwendung, wenn im Prozess eine Zugriffsverletzung auftritt.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ThrottleAccessViolationsPerSiteCollection

Gibt an, dass, wenn eine Arbeitsmappe einen Zugriffsverletzungsfehler für Excel Services Anwendung verursacht, alle Dateien, die aus der Websitesammlung dieser Arbeitsmappe stammen, für den angegebenen Zeitraum (in Sekunden) nicht geladen werden können. 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
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 wird 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.

The unattended account is a single account that all workbooks can use to refresh data. An unattended account is required when workbook connections specify None for authentication, or when any non-Windows credentials are used to refresh data.

Type:String
Position:Named
Default value:None
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 von allen Arbeitsmappen zum Aktualisieren von Daten verwendet werden kann. Dieses Konto ist erforderlich, um Daten zu aktualisieren, wenn Arbeitsmappenverbindungen "Unbeaufsichtigtes Dienstkonto verwenden" angeben, ohne Windows-Anmeldeinformationen zu verwenden.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013

-UnusedObjectAgeMax

Specifies the maximum amount of time, in minutes, that objects not currently used in a session are kept in the memory cache. Valid values include -1 for no maximum setting, and a positive integer in the range of 1 to 34560 minutes (24 days). The default value is -1.

Der Typ muss -1 oder eine ganze Zahl im Bereich von 1 bis 34560 sein.

Type:Int32
Position:Named
Default value:None
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 basieren, mit der Authentifizierungseinstellung "Konto des authentifizierten Benutzers verwenden".

Type:SwitchParameter
Position:Named
Default value:None
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
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 Anwendung verwendet werden.

Wenn kein Wert angegeben ist, 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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013