Set-PowerPivotServiceApplication-Cmdlet

Legt die Eigenschaften einer PowerPivot-Dienstanwendung fest.

Syntax

Set-PowerPivotServiceApplication [-Identity] <SPGeminiServiceApplicationPipeBind> [-AdministrationConnectionPoolSize <int>] [-AllowCustomWindowsCredentials] [-BusinessHoursEndTime <string>] [-BusinessHoursStartTime <string>] [-CachedDatabaseholdLimit <int>] [-Confirm <switch>] [-ConnectionPoolSize <int>] [-ConnectionPoolTimeout <int>] [-DataLoadTimeout <int>] [-DataRefreshFailureThreshold <int>] [-DataRefreshInactiveWorkbooksThreshold <int>] [-DataRefreshMaxHistory <int>] [-HealthBasedAllocation <switch>] [-LoadsToConnectionsRatioCollectionInterval <int>] [-LoadsToConnectionsRatioLimit <int>] [-MemoryDatabaseHoldLimit <int>] [-QueryReportingInterval <int>] [-RoundRobinAllocation <switch>] [-UnattendedAccount <string>] [-UsageDataRetentionPeriod <int>] [-UsageExpectedResponseUpperLimit <int>] [-UsageLongResponseUpperLimit <int>] [-UsageQuickResponseUpperLimit <int>] [-UsageTrivialResponseUpperLimit <int>] [-UsageUpdateDayLimit <int>] [<CommonParameters>]

Beschreibung

Das Set-PowerPivotServiceApplication-Cmdlet aktualisiert die Eigenschaften einer PowerPivot-Dienstanwendung in der Farm. Der Identity-Parameter ist erforderlich. Sie müssen die GUID der Dienstanwendung bereitstellen, für die Sie Eigenschaften aktualisieren.

Führen Sie das folgende Cmdlet aus, um die Änderungen zu überprüfen: Get-PowerPivotServiceApplication -Identity <GUID> | format-list.

Parameter

-Identity <SPGeminiServiceApplicationPipeBind>

Gibt die zu aktualisierende Dienstanwendung an. Der Typ muss eine gültige GUID oder eine Instanz eines gültigen PowerPivot-Dienstanwendungsobjekts sein. Sie können Get-PowerPivotServiceApplication verwenden, um eine Instanz des Objekts zurückzugeben.

Erforderlich?	true
Position?	0
Standardwert
Pipelineeingabe akzeptieren?	true
Platzhalterzeichen akzeptieren?	false

-AdministrationConnectionPoolSize <int>

Gibt die Anzahl der geöffneten Verbindungen in einem Verbindungspool an, der für eine PowerPivot-Dienstverbindung zu Analysis Services erstellt wurde. Jede PowerPivot-Dienstinstanz öffnet eine separate Administratorverbindung für die Analysis Services-Instanz auf dem gleichen Computer. Der PowerPivot-Dienst erstellt einen separaten Pool, damit Administratorverbindungen wiederverwendet werden können, um Verbindungen im Leerlauf zu suchen und den Serverzustand zu überwachen. Der Standardwert ist 200 Verbindungen. Gültige Werte sind -1 (unbegrenzt), 0 (deaktiviert administratives Verbindungspooling) oder 1 bis 10000. Wenn Sie 0 auswählen, wird jede Verbindung erneut erstellt.

Erforderlich?	false
Position?	benannt
Standardwert	200
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-AllowCustomWindowsCredentials [<SwitchParameter>]

Gibt an, ob Zeitplanbesitzer beliebige Windows-Anmeldeinformationen eingeben können, um einen Zeitplan zur Datenaktualisierung auszuführen. Wenn Sie dieses Kontrollkästchen aktivieren, erstellt und verwaltet die PowerPivot-Dienstanwendung eine Zielanwendung für jeden Satz gespeicherter Anmeldeinformationen. Die Standardeinstellung ist true. Legen Sie AllowCustomWindowsCredentials:$false fest, um diese Funktion zu deaktivieren.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-BusinessHoursEndTime <Zeichenfolge>

Gibt den Endpunkt in einem Bereich von Stunden an, die einen Geschäftstag definieren. Zeitpläne zur Datenaktualisierung können am Ende eines Geschäftstags ausgeführt werden, um die während der regulären Geschäftszeiten generierten Transaktionsdaten zu sammeln. Die Standardeinstellung ist 8:00 p.m. (20:00 Uhr). Gültige Werte werden in Anführungszeichen mit dem Zusatz AM oder PM angegeben (z. B. "08:00PM"). Der Stundenwert muss zwischen 1 und 12 liegen. Der Minutenwert muss zwischen 1 und 59 liegen.

Um für einen Geschäftstag den vollständigen Stundenbereich anzugeben, müssen Sie sowohl BusinessHoursStartTime als auch BusinessHoursEndTime festlegen. Mit diesen beiden Parametern wird das Stundenintervall für einen Geschäftstag definiert.

Erforderlich?	false
Position?	benannt
Standardwert	8 PM
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-BusinessHoursStartTime <Zeichenfolge>

Gibt den Startpunkt in einem Bereich von Stunden an, die einen Geschäftstag definieren. Zeitpläne zur Datenaktualisierung können am Ende eines Geschäftstags ausgeführt werden, um die während der regulären Geschäftszeiten generierten Transaktionsdaten zu sammeln. Die Standardeinstellung ist 4:00 a.m. Gültige Werte werden in Anführungszeichen mit dem Zusatz AM oder PM angegeben (z. B. "04:00AM"). Der Stundenwert muss zwischen 1 und 12 liegen. Der Minutenwert muss zwischen 1 und 59 liegen.

Um für einen Geschäftstag den vollständigen Stundenbereich anzugeben, müssen Sie sowohl BusinessHoursStartTime als auch BusinessHoursEndTime festlegen. Mit diesen beiden Parametern wird das Stundenintervall für einen Geschäftstag definiert.

Erforderlich?	false
Position?	benannt
Standardwert	4 AM
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-CachedDatabaseholdLimit <int>

Gibt an, wie viele Stunden eine inaktive Datenbank im Dateisystem beibehalten wird, nachdem sie aus dem Arbeitsspeicher entladen wurde. Der Standardwert beträgt 120 Stunden. Der Cleanupauftrag verwendet diese Einstellung, um die zu löschenden Dateien zu bestimmen. Alle PowerPivot-Datenbanken, die 168 Stunden (48 Stunden im Arbeitsspeicher und 120 Stunden im Cache) lang inaktiv sind, werden durch den Cleanupauftrag vom Datenträger gelöscht.

Erforderlich?	false
Position?	benannt
Standardwert	120
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Confirm <Schalter>

Fordert Ihre Bestätigung an, bevor der Befehl ausgeführt wird. Dieser Wert ist standardmäßig aktiviert. Geben Sie Confirm:$false für einen Befehl an, um die Bestätigungsantwort in einem Befehl zu umgehen.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-ConnectionPoolSize <int>

Gibt die maximale Anzahl von Verbindungen im Leerlauf an, die der PowerPivot-Dienst in einzelnen Verbindungspools für die einzelnen SharePoint-Benutzer, PowerPivot-Datasets und Versionskombinationen erstellt. Der Standardwert ist 1000 Verbindungen im Leerlauf. Gültige Werte sind -1 (unbegrenzt), 0 (deaktiviert das Benutzerverbindungspooling) oder 1 bis 10000. Durch diese Verbindungspools kann der Dienst fortlaufende Verbindungen desselben Benutzers mit den gleichen schreibgeschützten Daten effizienter unterstützen. Wenn Sie das Verbindungspooling deaktivieren, wird jede Verbindung erneut erstellt. Beachten Sie, dass Änderungen am Grenzwert für die Verbindungspoolgröße (auch die Festlegung auf 0) nicht dazu führen, dass Verbindungen getrennt werden. Verbindungspools sind vorhanden, um Wartezeiten beim Herstellen einer Verbindung mit Daten zu reduzieren. Der PowerPivot-Dienst wird nie eine Verbindung aufgrund von Verbindungspooleinstellungen ablehnen.

Erforderlich?	false
Position?	benannt
Standardwert	1000
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-ConnectionPoolTimeout <int>

Gibt an, wie viele Minuten eine Datenverbindung im Leerlauf geöffnet bleibt. Der Standardwert ist 1800 Sekunden (oder 30 Minuten). Während dieses Zeitraums wird eine Datenverbindung im Leerlauf für schreibgeschützte Anforderungen vom gleichen SharePoint-Benutzer für die gleichen PowerPivot-Daten von der PowerPivot-Dienstanwendung wiederverwendet. Wenn im angegebenen Zeitraum keine weiteren Anforderungen für diese Daten empfangen werden, wird die Verbindung aus dem Pool entfernt. Gültige Werte reichen von 1 bis 3600 Sekunden.

Erforderlich?	false
Position?	benannt
Standardwert	1800
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-DataLoadTimeout <int>

Gibt an, wie lange die PowerPivot-Dienstanwendung auf eine Antwort von der SQL Server Analysis Services (PowerPivot)-Instanz wartet, an die eine Anforderung zum Laden von Daten weitergeleitet wurde. Da die Übertragung sehr großer Datasets einige Zeit dauern kann, müssen Sie genügend Zeit vorsehen, damit die PowerPivot-Dienstinstanz die Excel-Arbeitsmappe abrufen und die PowerPivot-Daten zur Abfrageverarbeitung in eine Analysis Services-Instanz verschieben kann. Der Standardwert ist 1800 Sekunden (oder 30 Minuten). Gültige Werte reichen von 1 bis 3600 Sekunden.

Erforderlich?	false
Position?	benannt
Standardwert	1800
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-DataRefreshFailureThreshold <int>

Gibt die Anzahl der aufeinander folgenden Fehler an, nach der ein Zeitplan deaktiviert wird. Die Standardeinstellung ist 10. Sie können auch 0 eingeben, wenn ein Zeitplan aufgrund von Aktualisierungsfehlern nie deaktiviert werden soll.

Erforderlich?	false
Position?	benannt
Standardwert	10
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-DataRefreshInactiveWorkbooksThreshold <int>

Gibt die Anzahl von Datenaktualisierungszyklen ein, nach denen ein Zeitplan deaktiviert wird. Sie können auch 0 eingeben, wenn ein Zeitplan aufgrund von Inaktivität nie deaktiviert werden soll. Die Standardeinstellung ist 10 Zyklen.

Die Arbeitsmappeninaktivität wird als Fehlen von Verbindungsereignissen über mehrere Datenaktualisierungszyklen gemessen. Ein Datenaktualisierungszyklus wird jedes Mal gezählt, wenn ein Datenaktualisierungsvorgang ausgelöst wird (entweder vom Zeitplan oder einem "Jetzt ausführen"-Vorgang) , unabhängig davon, ob der Vorgang erfolgreich ist oder fehlschlägt. Nach Ablauf einer Anzahl von Zyklen (standardmäßig 10) ohne Verbindungsanforderungen für die Arbeitsmappe wird der Datenaktualisierungszeitplan wegen Inaktivität deaktiviert.

Erforderlich?	false
Position?	benannt
Standardwert	10
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-DataRefreshMaxHistory <int>

Gibt an, wie lange ein Verlaufsdatensatz der Datenaktualisierungsverarbeitung beibehalten wird. Diese Informationen werden auf den Seiten für den Datenaktualisierungsverlauf angezeigt, die für jede Arbeitsmappe angelegt werden, die die Datenaktualisierung nutzt. Sie werden auch im PowerPivot-Management-Dashboard angezeigt. Die Standardeinstellung ist 365 Tage.

Erforderlich?	false
Position?	benannt
Standardwert	365
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-HealthBasedAllocation <Schalter>

Gibt den zustandsbasierten Zuordnungsalgorithmus an, der Verbindungsanforderungen an den PowerPivot für SharePoint-Server mit der höchsten Verfügbarkeit an CPU- und Speicherressourcen weiterleitet. Dies ist der standardmäßige Zuordnungsalgorithmus. HealthBasedAllocation und RoundRobinBasedAllocation schließen sich gegenseitig aus. Sie müssen eines dieser Zuordnungsverfahren angeben. Wenn Sie beide Optionen auf false festlegen, wird HealthBasedAllocation verwendet, da dies die Standardeinstellung ist. Wenn Sie beide Optionen auf true festlegen, tritt ein Überprüfungsfehler auf. Als Syntax dieser Parameter können Sie entweder nur den Parameternamen oder parameter:$true bzw. parameter:$false eingeben.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-LoadsToConnectionsRatioCollectionInterval <int>

Geben Sie das Intervall (in Stunden) an, um Lade- und Verbindungsereignisse zum Berechnen des Lade-/Verbindungsverhältnisses zu berechnen. Standardmäßig berechnet das System alle 4 Stunden ein neues Verhältnis. Gültige Werte reichen von 1 bis 24.

Erforderlich?	false
Position?	benannt
Standardwert	4
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-LoadsToConnectionsRatioLimit <int>

Gibt das Verhältnis von Ladeereignissen und Verbindungsereignissen an, das als Indikator des Serverzustands verwendet wird. Die Standardeinstellung ist 20 Prozent.

Erforderlich?	false
Position?	benannt
Standardwert	20
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-MemoryDatabaseHoldLimit <int>

Gibt an, wie viele Stunden eine inaktive Datenbank im Arbeitsspeicher bleibt, falls neue Anforderungen für diese Daten empfangen werden. Eine aktive Datenbank wird immer im Arbeitsspeicher beibehalten, solange Sie sie abfragen. Wenn die Datenbank jedoch nicht mehr aktiv ist, behält das System sie für einen zusätzlichen Zeitraum im Arbeitsspeicher, falls es weitere Anforderungen für diese Daten gibt. Der Standardwert beträgt 48 Stunden.

Erforderlich?	false
Position?	benannt
Standardwert	48
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-QueryReportingInterval <int>

Gibt die Anzahl der Sekunden an, wie lange Statistikdaten zu Abfrageantworten gesammelt werden, bevor ein Verwendungsereignis in einen Bericht geschrieben wird. Der Standardwert ist 300 Sekunden.

Erforderlich?	false
Position?	benannt
Standardwert	300
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-RoundRobinAllocation <Schalter>

Gibt den Roundrobin-Zuordnungsalgorithmus an, der Verbindungsanfragen an den nächsten PowerPivot für SharePoint-Server weiterleitet. Dabei werden die Anforderungen unabhängig von der Serverlast gleichmäßig auf die verfügbaren Server aufgeteilt. HealthBasedAllocation und RoundRobinBasedAllocation schließen sich gegenseitig aus. Sie müssen eines dieser Zuordnungsverfahren angeben. Wenn Sie beide Optionen auf false festlegen, wird HealthBasedAllocation verwendet, da dies die Standardeinstellung ist. Wenn Sie beide Optionen auf true festlegen, tritt ein Überprüfungsfehler auf. Als Syntax dieser Parameter können Sie entweder nur den Parameternamen oder parameter:$true bzw. parameter:$false eingeben.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UnattendedAccount <Zeichenfolge>

Gibt den Zielanwendungsnamen einer Secure Store Service-Anwendung an, unter der ein vordefiniertes Konto zum Ausführen von PowerPivot-Datenaktualisierungsaufträgen gespeichert wird.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UsageDataRetentionPeriod <int>

Gibt die Anzahl der Tage an, wie lange ein Verlauf von Verwendungsdaten und Serverzustandsstatistiken beibehalten wird. Die Standardeinstellung beträgt 365 Tage. Wenn Sie diesen Wert auf 0 festlegen, wird der gesamte Verlauf unbegrenzt beibehalten.

Erforderlich?	false
Position?	benannt
Standardwert	365
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UsageExpectedResponseUpperLimit <int>

Legt eine Obergrenze fest, die die erwartete Dauer für den Austausch einer Anforderung/Antwort definiert. Der Standardwert ist 3000 Millisekunden. Jede Anforderung, die innerhalb von 1000 bis 3000 Millisekunden abgeschlossen wird, wird als erwartete Antwort für Berichterstellungszwecke angesehen.

Erforderlich?	false
Position?	benannt
Standardwert	3000
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UsageLongResponseUpperLimit <int>

Legt eine Obergrenze fest, die den Austausch einer Anforderung/Antwort mit langer Ausführungsdauer definiert. Die Obergrenze beträgt 10000 Millisekunden. Alle Anforderungen, die diese Obergrenze überschreiten, gehören zur Kategorie Überschritten, die keinen oberen Schwellenwert aufweist.

Erforderlich?	false
Position?	benannt
Standardwert	10000
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UsageQuickResponseUpperLimit <int>

Legt eine Obergrenze fest, die den Austausch einer schnellen Anforderung/Antwort definiert. Der Standardwert beträgt 1000 Millisekunden. Jede Anforderung, die innerhalb von 500 bis 1000 Millisekunden abgeschlossen wird, wird als schnelle Antwort für Berichterstellungszwecke angesehen.

Erforderlich?	false
Position?	benannt
Standardwert	1000
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UsageTrivialResponseUpperLimit <int>

Gibt eine Kategorie von Antwortzeiten an, die zu niedrig sind, um für Datensammlungszwecke als relevant angesehen zu werden. Die meisten Antworten, die in diese Kategorie fallen, sind der Server-zu-Server-Kommunikation zuzuordnen. Der Standardwert beträgt 500 Millisekunden. Jede Anforderung, die innerhalb von 0 bis 500 Millisekunden abgeschlossen wird, ist eine triviale Anforderung und wird bei der Berichterstellung ignoriert.

Erforderlich?	false
Position?	benannt
Standardwert	500
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UsageUpdateDayLimit <int>

Geben Sie den Schwellenwert (in Tagen) zum Auslösen einer Warnung an, wenn beim Aktualisieren der Datendatei, die im PowerPivot-Management-Dashboard verwendet wird, ein Fehler aufgetreten ist. Standardmäßig aktualisiert das System die Verwendungsdaten täglich. Die Datei PowerPivot Management Dashboard.xlsx, die als Datenquelle für Administratorberichte dient, wird nach dem gleichen Zeitplan aktualisiert. Wenn die XLSX-Datei über mehrere Tage hinweg nicht aktualisiert wird, wird eine Integritätsregel ausgelöst, die darauf hinweist, dass die Datei veraltet ist. Die Standardeinstellung beträgt 5 Tage. Gültige Werte sind 1 bis 30.

Erforderlich?	false
Position?	benannt
Standardwert	5
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer und OutVariable. Weitere Informationen finden Sie unter About_CommonParameters.

Eingaben und Ausgaben

Mit dem Eingabetyp wird festgelegt, welchen Typ von Objekten Sie über die Pipeline an das Cmdlet übergeben können. Der Rückgabetyp bezeichnet den Typ der vom Cmdlet zurückgegebenen Objekte.

Eingaben	Keine
Ausgaben	Keine

Beispiel 1

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklm -AllowCustomWindowsCredentials:$false -UnattendedAccount "MyTargetApp"

In diesem Beispiel wird eine Datenaktualisierungsfunktion deaktiviert, die automatisch Secure Store Service-Zielanwendungen zum Speichern von beliebigen Windows-Anmeldeinformationen erstellt und verwaltet. Außerdem wird das PowerPivot-Konto für die unbeaufsichtigte Datenaktualisierung auf eine vordefinierte Zielanwendung festgelegt.

Verwenden Sie Get-powerpivotserviceapplication, um eine gültige Identität abzurufen.

Beispiel 2

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklm -HealthBasedAllocation

In diesem Beispiel wird der zustandsbasierte Zuordnungsalgorithmus angegeben, der Verbindungsanforderungen an den Server weiterleitet, auf dem die meisten Ressourcen verfügbar sind.

Verwenden Sie Get-powerpivotserviceapplication, um eine gültige Identität abzurufen.

Beispiel 3

C:\PS>Set-PowerPivotServiceApplication -identity 1234567-890a-bcde-fghijklmn -BusinessHoursStartTime "07:15AM" -BusinessHoursEndTime "08:00PM"

In diesem Beispiel wird veranschaulicht, wie Sie die Anfangs- und Endstunden eines Geschäftstags festlegen, was als Zeitplanoption zum Planen der PowerPivot-Datenaktualisierung verwendet wird. In Zeitplänen kann eine Option für die Zeit nach den Geschäftsstunden angegeben werden, in der am Ende eines Geschäftstags die Datenaktualisierung ausgeführt wird.

Verwenden Sie Get-powerpivotserviceapplication, um eine gültige Identität abzurufen.