Set-SPExcelFileLocation
Legt Eigenschaften eines vertrauenswürdigen Dateispeicherorts für eine Excel Services-Anwendung fest.
Syntax
Set-SPExcelFileLocation
[-Identity] <SPExcelFileLocationPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AbortOnRefreshOnOpenFail]
[-Address <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-AutomaticVolatileFunctionCacheLifetime <Int32>]
[-ChartAndImageSizeMax <Int32>]
[-ConcurrentDataRequestsPerSessionMax <Int32>]
[-Confirm]
[-DefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
[-Description <String>]
[-DisplayGranularExtDataErrors]
[-ExternalDataAllowed <AllowExternalData>]
[-IncludeChildren]
[-LocationType <LocationType>]
[-ManualExtDataCacheLifetime <Int32>]
[-NewWorkbookSessionTimeout <Int32>]
[-PeriodicExtDataCacheLifetime <Int32>]
[-RequestDurationMax <Int32>]
[-RESTExternalDataAllowed]
[-SessionTimeout <Int32>]
[-ShortSessionTimeout <Int32>]
[-UdfsAllowed]
[-WarnOnDataRefresh]
[-WhatIf]
[-WorkbookSizeMax <Int32>]
[-ChartRenderDurationMax <Int32>]
[<CommonParameters>] Beschreibung
Das Set-SPExcelFileLocation Cmdlet legt Eigenschaften eines Speicherorts fest, von dem Excel Services Anwendung Arbeitsmappen lädt.
Excel Services Anwendung lädt nur Arbeitsmappen, die an einem vertrauenswürdigen Dateispeicherort gespeichert sind.
Eigenschaften von vertrauenswürdigen Dateispeicherorten steuern, wie Arbeitsmappen verwendet werden können, wenn sie in Excel Services Anwendung geladen werden.
Excel Services Anwendung erzwingt immer die Eigenschaften, die durch den vertrauenswürdigen Dateispeicherort definiert werden, aus dem eine Arbeitsmappe geladen wurde.
Die Eigenschaften, die vom vertrauenswürdigen Dateispeicherort verwendet werden, werden durch Vergleichen des Dateipfads für die Arbeitsmappe mit dem Parameter Address für den vertrauenswürdigen Dateispeicherort bestimmt.
Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.
Beispiele
--------------BEISPIEL 1--------------
Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed DclIn diesem Beispiel wird jeder vertrauenswürdige Dateispeicherort für die Excel Services Application Web Service-Anwendung mit dem Namen Mein Excel-Dienst abgerufen, die das Laden von Datenverbindungen aus Arbeitsmappendateien zulässt, und gibt an, dass die Speicherorte eine Datenverbindungsbibliothek zum Laden von Datenverbindungen verwenden müssen.
--------------BEISPIEL 2--------------
Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "https://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services Application. It allows any file from anywhere in SharePoint to load."In diesem Beispiel wird die Beschreibung des Standarddateispeicherorts für jede Excel Services Anwendungswebdienstanwendung in der Farm geändert.
Parameter
-AbortOnRefreshOnOpenFail
Gibt an, dass beim Laden einer Excel Services Application-Datei automatisch ein Fehler auftritt, wenn ein automatischer Datenaktualisierungsvorgang fehlschlägt, wenn die Datei geöffnet wird. Der Fehler beim Laden tritt nur auf, wenn die folgenden Bedingungen erfüllt sind:
– Der Benutzer verfügt über schreibgeschützte Berechtigungen für die Excel Services Anwendungsdatei. -- Die Arbeitsmappendatei weist Datenverbindungen auf, die beim Öffnen der Excel-Datei automatisch aktualisiert werden.
| 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 |
-Address
System.String
Gibt einen Webordner oder ein Dateiverzeichnis an, aus dem Excel Services Anwendung Arbeitsmappen laden kann.
Der Typ muss eine gültige URL im Format https://myPortal/myTeamoder ein gültiger UNC-Pfad im Formular \\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 |
-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 |
-AutomaticVolatileFunctionCacheLifetime
Gibt die maximale Zeit in Sekunden an, die ein berechneter Wert für eine veränderliche Funktion für automatische Neuberechnungen zwischengespeichert wird. Gültige Werte sind:
-1, einmalige Berechnung beim Laden der Arbeitsmappe
0, stets neu berechnen
1 bis 2073600, von 1 Sekunde bis zu 24 Tagen zwischenspeichern
Der Typ muss aus den ganzen Zahlen -1 oder 0 oder einem ganzzahligen Wert im Bereich von 1 bis 2073600 bestehen.
| 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 |
-ChartAndImageSizeMax
Gibt die maximale Größe in MB für ein zu öffnendes Diagramm oder Bild an. Der Standardwert ist 1.
Der Typ muss eine gültige ganze Zahl größer als 0 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 |
-ChartRenderDurationMax
Die maximale Zeit (in Sekunden), die für das Rendern eines einzelnen Diagramms aufgewendet wird.
Gültige Werte: -1 (kein Grenzwert); von 1 bis 2073600 (24 Tage).
| 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 |
-ConcurrentDataRequestsPerSessionMax
Gibt die maximale Anzahl gleichzeitiger externer Datenanforderungen an, die je Sitzung zulässig sind. Wenn eine Sitzung mehr als diese Anzahl Anforderungen ausgeben muss, müssen weitere Anforderungen in die Warteschlange eingestellt werden. Der Gültigkeitsbereich für diese Einstellung ist der logische Server. Der Standardwert ist 5.
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 |
-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 |
-DefaultWorkbookCalcMode
Gibt den Berechnungsmodus für Arbeitsmappen an. Alle Einstellungen mit Ausnahme der Einstellung File überschreiben die Einstellungen für die Arbeitsmappe. Wenn dieser Parameter geändert wird, wird er auf alle neuen Sitzungen in Excel Services Application angewendet, wenn der ConfigDB-Eigenschaftencache aktualisiert wird. Die Standardeinstellung ist File.
Der Typ muss einer der folgenden Werte sein: File, Manual, Auto oder AutoDataTables.
| Type: | DefaultWorkbookCalcMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Description
Gibt eine Klartextbeschreibung für den neuen Dateispeicherort an.
Der Typ muss eine gültige Zeichenfolge sein, z. B.: "Speicherort für den monatlichen Vertriebsbericht".
| 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 |
-DisplayGranularExtDataErrors
Zeigt granuläre Fehlermeldungen für externe Datenfehler für Dateien an diesem Speicherort an.
| 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 |
-ExcelServiceApplication
Gibt die Excel Services Application-Webdienstanwendung an, die das SPExcelFileLocation-Listenobjekt enthält.
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: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExternalDataAllowed
Gibt den Typ des für Arbeitsmappen zulässigen externen Datenzugriffs an: Keine gibt an, dass die Datenaktualisierung deaktiviert ist. Dcl gibt an, dass Daten nur aktualisiert werden, wenn sie eine Verbindungsdatei in einer vertrauenswürdigen Datenverbindungsbibliothek verwenden. DclandEmbedded gibt an, dass eine Datenverbindungsdatei verwendet werden kann, jedoch nicht erforderlich ist. Der Gültigkeitsbereich für diese Einstellung ist der vertrauenswürdige Speicherort.
Der Standardwert ist None.
Der Typ muss einer der folgenden sein: None, Dcl oder DclAndEmbedded.
| Type: | AllowExternalData |
| 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 FileLocation-Objekt an. Der Name muss in der Liste der Dateispeicherorte eindeutig sein.
Der Typ muss eine gültige GUID im Format 12345678-90ab-cdef-1234-567890bcdefgh sein; eine gültige Zeichenfolge, die den Dateispeicherort im Format https://myPortal/myTeamangibt, eine gültige Zeichenfolge, die den Pfad identifiziert, im Format C:\folder_name oder eine Instanz eines gültigen SPExcelFileLocation-Objekts.
| Type: | SPExcelFileLocationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-IncludeChildren
Gibt an, dass untergeordnete URLs, Verzeichnisse und Bibliotheken als vertrauenswürdig angesehen werden. Wenn der vertrauenswürdige Dateispeicherort beispielsweise ist https://portalund IncludeChildren true ist, https://portal/subSite ist ebenfalls vertrauenswürdig, ebenso wie jede subURL unter der url, die unter Adresse angegeben ist.
| 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 |
-LocationType
Der Typ des Speicherorts. LocationType gibt an, wie Excel Services Application Dateien von dem in Address angegebenen Speicherort abruft. Der Standardwert ist SharePoint.
Der Typ muss einer der folgenden sein: SharePoint, UNC oder HTTP.
| Type: | LocationType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ManualExtDataCacheLifetime
Gibt die Zeit in Sekunden an, die Excel Services Anwendung wartet, bevor eine manuelle oder vom Benutzer initiierte externe Datenanforderung erneut ausgegeben wird. Während dieses Zeitraums können von einem externen Datencache die Ergebnisse der vorhergehenden externen Datenanforderung zurückgegeben werden.
Gültige Werte sind:
-1 Nie nach der ersten Abfrage aktualisieren
1 bis 2073600 Caches 1 Sekunde bis 24 Tage.
Der Standardwert ist 300.
| 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 |
-NewWorkbookSessionTimeout
Gibt die Zeit in Sekunden an, die eine Sitzung für eine neue, nicht gespeicherte Arbeitsmappe in Excel Services Anwendung ohne Benutzeraktivität aktiv bleibt. Der Standardwert ist 1800. Zu den gültigen Werten gehören die folgenden:
-1, Sitzung läuft nie ab
0: Sitzung läuft am Ende einer einzelnen Anforderung ab
1 bis 2073600, bleiben Sie 1 Sekunde bis 24 Tage aktiv.
Der Typ muss -1, 0 oder eine ganze Zahl im Bereich von 1 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 |
-PeriodicExtDataCacheLifetime
Gibt die Zeit in Sekunden an, die Excel Services Anwendung wartet, bevor eine geöffnete oder regelmäßige (automatische) externe Datenanforderung erneut ausgegeben wird. Während dieses Zeitraums können von einem externen Datencache die Ergebnisse der vorhergehenden externen Datenanforderung zurückgegeben werden. Der Wert -1 gibt an, dass nach der ersten Abfrage keine Aktualisierung stattfindet.
Der Typ muss -1, 0 oder eine ganze Zahl im Bereich von 1 bis 2073600 sein.
Der Standardwert ist 300.
| 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 |
-RequestDurationMax
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.
| 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 |
-RESTExternalDataAllowed
Gibt an, ob Anforderungen vom REST-API (Representational State Transfer Application Programming Interface) zum Aktualisieren von externen Datenverbindungen zulässig sind.
Der RESTExternalDataAllowed-Parameter hat keine Auswirkung, wenn der Parameter External DataAllowed auf None festgelegt ist.
| 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 |
-SessionTimeout
Gibt die Zeit in Sekunden an, die eine Sitzung in Excel Services Anwendung ohne Benutzeraktivität aktiv bleibt. Die Standardeinstellung ist 300 Sekunden. Der Standardwert ist 300. Gültige Werte sind:
-1, die Sitzung läuft nicht ab
0: Sitzung läuft am Ende einer einzelnen Anforderung ab
1 bis 2073600, die Sitzung bleibt von 1 Sekunde bis zu 24 Tagen aktiv
Der Typ muss -1, 0 oder eine ganze Zahl im Bereich von 1 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 |
-ShortSessionTimeout
Gibt den Zeitraum in Sekunden an, der dem Benutzer für die erste Interaktion mit einer Kalkulationstabelle zur Verfügung steht. Nach dem Verstreichen dieser Zeit wird die Sitzung geschlossen, wenn der Benutzer nicht aktiv ist. Der Wert muss immer kleiner als SessionTimeout sein. Wenn der ShortSessionTimeout-Wert größer oder gleich SessionTimeout ist, wird ein Fehler zurückgegeben. Der Standardwert lautet 75.
Der Typ muss -1 oder eine ganze Zahl im Bereich von 1 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 |
-UdfsAllowed
Gibt an, dass benutzerdefinierte Funktionen von Arbeitsmappen aufgerufen werden können, die von dem in Address angegebenen vertrauenswürdigen Dateispeicherort geladen wurden.
| 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 |
-WarnOnDataRefresh
Gibt an, dass dem Benutzer bei der ersten Aktualisierung von Daten in der Arbeitsmappe eine Warnung angezeigt wird. Der Standardwert lautet "True".
| 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 |
-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 |
-WorkbookSizeMax
Gibt die maximale Größe einer zu ladenden Arbeitsmappe in MB an. Der Standardwert ist 10.
Der Typ muss ein ganzzahliger Wert im Bereich von 1 bis 2000 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 |
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