New-SPExcelFileLocation

Fügt der Excel Services-Anwendung einen neuen vertrauenswürdigen Speicherort hinzu.

Syntax

New-SPExcelFileLocation
   -Address <String>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-AbortOnRefreshOnOpenFail]
   [-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 New-SPExcelFileLocation Cmdlet fügt der Liste der vertrauenswürdigen Dateispeicherorte in einer Excel Services Application Web Service-Anwendung einen neuen Speicherort hinzu. 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 vom vertrauenswürdigen Dateispeicherort verwendeten Eigenschaften werden durch Vergleich des Dateipfads der Arbeitsmappe mit dem Parameter Address des vertrauenswürdigen Dateispeicherorts bestimmt.

Die längste Übereinstimmung erhält den Vorrang. Wenn und https://portal/site/subsite beispielsweise https://portal/site/ vertrauenswürdige Speicherorte sind und Sie eine Arbeitsmappe von der Unterwebsite laden, verwendet die Anwendung die Eigenschaften des vertrauenswürdigen Speicherorts der Unterwebsite, da sie über die längste übereinstimmende Adresse verfügt.

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-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

In diesem Beispiel wird der Liste der vertrauenswürdigen Dateispeicherorte, die sich in der Excel Services Application-Webdienstanwendung namens MyExcelService befindet, ein neuer vertrauenswürdiger Dateispeicherort hinzugefügt.

In diesem Beispiel können Arbeitsmappen aus einem beliebigen untergeordneten Oder Unterordner geladen werden, der mit beginnt. https://myPortal/myTeam. Alle von diesem Speicherort geladenen Arbeitsmappen müssen kleiner als 50 MB sein. Die Arbeitsmappen können externe Daten mithilfe von Verbindungen aktualisieren, die in der Arbeitsmappendatei eingebettet oder in einer Datenverbindungsbibliothek gespeichert sind. Es wird keine Warnmeldung angezeigt, dass die Arbeitsmappe versucht, externe Daten zu aktualisieren.

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

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."

In diesem Beispiel wird der Liste der vertrauenswürdigen Dateispeicherorte, die sich in der Excel Services Application-Webdienstanwendung mit dem Namen MyExcelService befindet, ein neuer vertrauenswürdiger Dateispeicherort mit einer angegebenen Adresse und Beschreibung hinzugefügt.

Parameter

-AbortOnRefreshOnOpenFail

Gibt an, dass beim Laden einer Excel Services Application-Datei automatisch ein Fehler auftritt, wenn beim Öffnen der Datei ein Automatischer Datenaktualisierungsvorgang fehlschlägt. Der Fehler beim Laden tritt nur auf, wenn die folgenden Bedingungen erfüllt sind:

  • Der Benutzer verfügt über SharePoint-Produkt- und -Technologien-Leseberechtigungen für die Datei.
  • Die Arbeitsmappendatei verfügt über Datenverbindungen, die automatisch aktualisiert werden, wenn die Excel Services Anwendungsdatei geöffnet 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

-Address

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:True
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 Berechnet einmal, wann die Arbeitsmappe geladen wird.

0 Wird immer berechnet.

1 bis 2073600 Caches 1 Sekunde bis 24 Tage. Der standardmäßige ganzzahlige Wert ist 300.

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

{{Fill ChartRenderDurationMax Description}}

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. Jede andere Einstellung als File setzt die Arbeitsmappeneinstellungen außer Kraft. 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. None 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 eine der folgenden Einstellungen sein:

Keine

Dcl

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

-IncludeChildren

Gibt an, dass untergeordnete URLs, Verzeichnisse und Bibliotheken als vertrauenswürdig angesehen werden. Wenn beispielsweise der vertrauenswürdige Dateispeicherort ist https://portal und IncludeChildren true ist, https://portal/subSite ist ebenfalls vertrauenswürdig, ebenso wie jede URL, die der in Address angegebenen URL untergeordnet 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

Gibt den Typ des Speicherorts an. Location type gibt an, wie Excel Services Application Dateien aus dem unter Adresse angegebenen Speicherort abruft. Die Standardeinstellung ist der Typ SharePoint. 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 sie eine manuelle oder vom Benutzer initiierte externe Datenanforderung erneut ausgibt. Während dieses Zeitraums können von einem externen Datencache die Ergebnisse der vorhergehenden externen Datenanforderung zurückgegeben werden. Der Standardwert ist 300.

Zu den gültigen Werten zählen alle der folgenden Einträge:

-1 Keine Aktualisierung nach der ersten Abfrage1 bis 2073600 - Speichert von 1 Sekunde bis zu 24 Tagen zwischen.

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. 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 Bleibt 1 Sekunde bis 24 Tage aktiv. Der standardmäßige ganzzahlige Wert ist 1800.

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 periodische (d. h. 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 Standardwert ist 300.

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

-RequestDurationMax

Gibt die maximale Dauer in Sekunden für eine einzelne Anforderung in einer Sitzung an. Nach Ablauf dieser Zeit ist für die Anforderung ein Timeout aufgetreten. Der Standardwert ist 300.

Der Typ muss -1 (keine Einschränkung) 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

-RESTExternalDataAllowed

Gibt an, ob Anforderungen vom REST-API (Representational State Transfer Application Programming Interface) zum Aktualisieren von externen Datenverbindungen zulässig sind. Der Parameter RESTExternalDataAllowed weist keine Wirkung auf, wenn der Parameter ExternalDataAllowed 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. 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 Bleibt 1 Sekunde bis 24 Tage aktiv. Der Standardwert ist 300.

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.

Der Standardwert ist False.

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