Applet de commande Set-PowerPivotServiceApplication

Définit les propriétés d'une application de service PowerPivot.

S'applique à : SharePoint 2010 et SharePoint 2013.

Syntaxe

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>]

Description

L'applet de commande Set-PowerPivotServiceApplication met à jour les propriétés d'une application de service PowerPivot dans la batterie. Le paramètre Identity est obligatoire. Vous devez fournir le GUID de l'application de service dont vous mettez à jour les propriétés.

Pour vérifier vos modifications, exécutez l'applet de commande suivante : Get-PowerPivotServiceApplication -Identity <GUID> | format-list.

Paramètres

-Identity <SPGeminiServiceApplicationPipeBind>

Spécifie l'application de service à mettre à jour. Le type doit être un GUID valide ou une instance d'un objet d'application de service PowerPivot valide. Vous pouvez utiliser Get-PowerPivotServiceApplication pour retourner une instance de l'objet.

-AdministrationConnectionPoolSize <entier>

Spécifie le nombre de connexions ouvertes dans un pool de connexions créé pour une connexion de service PowerPivot à Analysis Services. Chaque instance de service PowerPivot ouvre une connexion d'administration distincte avec une instance Analysis Services sur le même ordinateur. Le service PowerPivot crée un pool distinct pour réutiliser les connexions d'administration en vue de vérifier si des connexions sont inactives et de contrôler l'intégrité du serveur. La valeur par défaut est 200 connexions. Les valeurs valides sont -1 (illimité), 0 (désactive le regroupement de connexions administrateur) ou 1 à 10000. Si vous sélectionnez 0, chaque connexion est recréée.

-AllowCustomWindowsCredentials [<SwitchParameter>]

Spécifie si les propriétaires de la planification peuvent entrer des informations d'identification Windows arbitraires pour exécuter une planification d'actualisation des données. Si vous sélectionnez cette case à cocher, l'application de service PowerPivot crée et gère une application cible pour chaque ensemble d'informations d'identification stockées. La valeur par défaut est true. Pour désactiver cette fonctionnalité, définissez AllowCustomWindowsCredentials:$false.

-BusinessHoursEndTime <chaîne>

Spécifie le point de fin d'une plage horaire qui définit une journée de travail. Les planifications d'actualisation des données peuvent s'exécuter à la fin d'une journée de travail pour récupérer les données transactionnelles qui ont été générées pendant les heures d'ouverture normales. la valeur par défaut est 8:00 p.m. Les valeurs valides sont spécifiées entre guillemets, avec l'indication a.m. (pour le matin) ou p.m. (pour l'après-midi) (par exemple, « 08:00 PM ». Les heures doivent être comprises entre 1 et 12. Les minutes doivent être comprises entre 1 et 59.

Pour spécifier la plage complète des heures de travail, vous devez définir BusinessHoursStartTime et BusinessHoursEndTime. Les deux paramètres définissent l'intervalle horaire qui compose une journée de travail.

-BusinessHoursStartTime <chaîne>

Spécifie le point de début d'une plage horaire qui définit une journée de travail. Les planifications d'actualisation des données peuvent s'exécuter à la fin d'une journée de travail pour récupérer les données transactionnelles qui ont été générées pendant les heures d'ouverture normales. La valeur par défaut est 4:00 a.m. Les valeurs valides sont spécifiées entre guillemets, avec l'indication a.m. (pour le matin) ou p.m. (pour l'après-midi) (par exemple, « 04:00AM ») Les heures doivent être comprises entre 1 et 12. Les minutes doivent être comprises entre 1 et 59.

Pour spécifier la plage complète des heures de travail, vous devez définir BusinessHoursStartTime et BusinessHoursEndTime. Les deux paramètres définissent l'intervalle horaire qui compose une journée de travail.

-CachedDatabaseholdLimit <entier>

Spécifie la durée (en heures) pendant laquelle une base de données inactive est conservée dans le système de fichiers après avoir été déchargée de la mémoire. La valeur par défaut est de 120 heures. Le travail de nettoyage utilise ce paramètre pour déterminer les fichiers à supprimer. Toutes les bases de données PowerPivot qui sont inactives pendant 168 heures (48 heures en mémoire et 120 heures dans le cache) sont supprimées du disque par le travail de nettoyage.

-Confirm <commutateur>

Demande une confirmation avant d'exécuter la commande. Cette valeur est activée par défaut. Pour contourner la réponse de confirmation dans une commande, spécifiez Confirm:$false sur la commande.

-ConnectionPoolSize <entier>

Spécifie le nombre maximal de connexions inactives que le service PowerPivot créera dans les pools de connexions pour chaque utilisateur SharePoint, dataset PowerPivot et les combinaisons de version. La valeur par défaut est 1 000 connexions inactives. Les valeurs valides sont -1 (illimité), 0 (désactive le regroupement de connexions utilisateur) ou une plage comprise entre 1 et 10000. Ces pools de connexions permettent au service de gérer plus efficacement les connexions aux mêmes données en lecture seule par le même utilisateur. Si vous désactivez le regroupement de connexions, chaque connexion sera recréée. Notez que la modification de la limite de taille du pool de connexions, y compris son paramétrage sur la valeur 0, ne provoque pas de perte de connexion. Les pools de connexions servent à réduire les temps d'attente lors de la connexion aux données. Le service PowerPivot ne refuse jamais une connexion reposant sur les paramètres du pool de connexions.

-ConnectionPoolTimeout <entier>

Spécifie la durée (en minutes) pendant laquelle une connexion de données inactive restera ouverte. La valeur par défaut est 1800 secondes (ou 30 minutes). Durant ce laps de temps, l'application de service PowerPivot réutilisera une connexion de données inactive pour les demandes en lecture seule émanant du même utilisateur SharePoint pour les mêmes données PowerPivot. Si aucune demande supplémentaire n'est reçue pour ces données pendant la période spécifiée, la connexion est supprimée du pool. Les valeurs valides sont comprises entre 1 et 3600 secondes.

-DataLoadTimeout <entier>

Spécifie le délai pendant lequel l'application de service PowerPivot attend une réponse de l'instance SQL Server Analysis Services (PowerPivot) à laquelle elle a transféré une requête de chargement de données. Étant donné que l'acheminement sur le réseau des datasets très volumineux prend du temps, vous devez accorder à l'instance de service PowerPivot suffisamment de temps pour récupérer le classeur Excel et déplacer les données PowerPivot vers une instance Analysis Services pour le traitement de la requête. La valeur par défaut est 1800 secondes (ou 30 minutes). Les valeurs valides sont comprises entre 1 et 3 600 secondes.

-DataRefreshFailureThreshold <entier>

Spécifie le nombre d'échecs consécutifs à l'issue duquel une planification est désactivée. La valeur par défaut est 10. Vous pouvez également entrer 0 pour ne jamais désactiver une planification suite à un échec d'actualisation.

-DataRefreshInactiveWorkbooksThreshold <entier>

Spécifiez le nombre de cycles d'actualisation des données à l'issue duquel une planification est désactivée, ou entrez 0 pour ne jamais désactiver une planification en raison d'une inactivité. La valeur par défaut est 10 cycles.

L'inactivité des classeurs est mesurée comme l'absence d'événements de connexion sur plusieurs cycles d'actualisation des données. Un cycle d'actualisation des données est compté chaque fois qu'une opération d'actualisation des données est déclenchée (par la planification ou par une opération Exécuter maintenant), indépendamment de la réussite ou de l'échec de l'opération. Si plusieurs cycles passent (10 par défaut) sans qu'il y ait de demande de connexion pour le classeur, la planification de l'actualisation des données est désactivée en raison d'une inactivité.

-DataRefreshMaxHistory <entier>

Spécifie la durée de rétention d'un enregistrement d'historique du traitement de l'actualisation des données. Ces informations s'affichent dans les pages d'historique de l'actualisation des données qui sont conservées pour chaque classeur utilisant l'actualisation des données. Elles s'affichent également dans le tableau de bord de gestion PowerPivot. La valeur par défaut est 365 jours.

-HealthBasedAllocation <commutateur>

Spécifie l'algorithme d'allocation basé sur l'intégrité qui transfère les requêtes de connexion serveur au serveur PowerPivot pour SharePoint qui a le plus de ressources processeur et de mémoire disponibles. Il s'agit de l'algorithme d'allocation par défaut. HealthBasedAllocation et RoundRobinBasedAllocation s'excluent mutuellement. Vous devez spécifier l'un ou l'autre. Si vous leur attribuez tous deux la valeur false, HealthBasedAllocation sera utilisé car il s'agit de la valeur par défaut. Si vous leur attribuez tous deux la valeur true, vous obtiendrez une erreur de validation. La syntaxe de ces paramètres inclut soit la saisie du nom du paramètre seul, soit la saisie de parameter:$true ou de parameter:$false.

-LoadsToConnectionsRatioCollectionInterval <entier>

Spécifiez l'intervalle (en heures) pendant lequel calculer les événements de charge et de connexion pour le calcul du rapport charge/connexion. Par défaut, le système calcule un nouveau taux toutes les 4 heures. Les valeurs valides sont comprises entre 1 et 24.

-LoadsToConnectionsRatioLimit <entier>

Spécifie le rapport d'événements de calcul par rapport aux événements de connexion qui est utilisé en tant qu'indicateur de l'intégrité du serveur. La valeur par défaut est 20 pour cent.

-MemoryDatabaseHoldLimit <entier>

Spécifie le nombre d'heures pendant lequel une base de données inactive est conservée en mémoire pour répondre aux nouvelles requêtes de données. Une base de données active est toujours conservée en mémoire tant que vous l'interrogez ; lorsqu'elle n'est plus active, le système la conserve en mémoire pour une période supplémentaire au cas où ces données seraient interrogées ultérieurement. L'intervalle par défaut est de 48 heures.

-QueryReportingInterval <entier>

Spécifie la durée en secondes pendant laquelle collecter les statistiques de réponse aux requêtes avant de les rapporter comme événement d'utilisation. La valeur par défaut est 300 secondes.

-RoundRobinAllocation <commutateur>

Spécifie l'algorithme d'allocation de tourniquet (round robin) qui transfère les demandes de connexion au serveur PowerPivot pour SharePoint suivant, en répartissant les requêtes de manière égale entre les serveurs disponibles, quelle que soit la charge du serveur. HealthBasedAllocation et RoundRobinBasedAllocation s'excluent mutuellement. Vous devez spécifier l'un ou l'autre. Si vous leur attribuez tous deux la valeur false, HealthBasedAllocation sera utilisé car il s'agit de la valeur par défaut. Si vous leur attribuez tous deux la valeur true, vous obtiendrez une erreur de validation. La syntaxe de ces paramètres inclut soit la saisie du nom du paramètre seul, soit la saisie de parameter:$true ou de parameter:$false.

-UnattendedAccount <chaîne>

Spécifie le nom de l'application cible d'une application de service Banque d'informations sécurisé qui stocke un compte prédéfini pour l'exécution des travaux d'actualisation des données PowerPivot.

-UsageDataRetentionPeriod <entier>

Spécifie le nombre de jours pendant lequel l'historique des données d'utilisation et des statistiques d'intégrité du serveur est conservé. La valeur par défaut est 365 jours. La valeur 0 conserve tous les historiques indéfiniment.

-UsageExpectedResponseUpperLimit <entier>

Définit une limite maximale qui définit un échange requête-réponse attendue. La valeur par défaut est 3 000 millisecondes. Toute requête dont la durée d'exécution est comprise entre 1000 et 3000 millisecondes est considérée comme une réponse attendue à des fins de création de rapports.

-UsageLongResponseUpperLimit <entier>

Définit une limite maximale qui définit un échange requête-réponse long. La limite maximale est de 10 000 millisecondes. Toute demande qui dépasse cette limite est classée dans la catégorie Hors limite pour laquelle il n'existe pas de seuil maximal.

-UsageQuickResponseUpperLimit <entier>

Définit une limite maximale qui définit un échange requête-réponse rapide. La valeur par défaut est 1 000 millisecondes. Toute requête dont la durée d'exécution est comprise entre 500 et 1000 millisecondes est considérée comme une réponse rapide à des fins de création de rapports.

-UsageTrivialResponseUpperLimit <entier>

Spécifie une catégorie de temps de réponse trop courts pour être considérés comme pertinents pour la collecte de données. La plupart des réponses faisant partie de cette catégorie sont des communications de serveur à serveur. Par défaut, cette valeur est de 500 millisecondes. Toute demande dont la durée d'exécution est comprise entre 0 et 500 millisecondes est une demande triviale ; elle est ignorée à des fins de création de rapports.

-UsageUpdateDayLimit <entier>

Spécifiez le seuil (en jours) de déclenchement d'un avertissement en cas d'échec d'actualisation du fichier de données utilisé par les rapports du Tableau de bord de gestion PowerPivot. Par défaut, le système met quotidiennement à jour les données d'utilisation. Le fichier PowerPivot Management Dashboard.xlsx, qui est la source de données pour les rapports d'administration, est actualisé sur la même planification. Si le fichier .xlsx n'est pas mis à jour pendant un nombre de jours donné, une règle d'intégrité est générée pour indiquer que le fichier est obsolète. La valeur par défaut est 5 jours. Les valeurs valides sont comprises entre 1 et 30.

<CommonParameters>

Cette applet de commande prend en charge les paramètres communs : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer et OutVariable. Pour plus d'informations, consultez About_CommonParameters.

Entrées et sorties

Le type d'entrée correspond au type des objets que vous pouvez canaliser vers l'applet de commande. Le type de retour correspond au type des objets retournés par l'applet de commande.

Exemple 1

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

Cet exemple désactive une fonctionnalité d'actualisation des données qui crée et gère automatiquement les applications cibles de service Banque d'informations sécurisé pour le stockage des informations d'identification Windows arbitraires. Il définit également le compte d'actualisation des données PowerPivot sans assistance sur une application cible prédéfinie.

Utilisez Get-powerpivotserviceapplication pour obtenir une identité valide.

Exemple 2

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

Cet exemple spécifie l'algorithme d'allocation basé sur l'intégrité qui transfère les requêtes de connexion au serveur qui a le plus de ressources disponibles.

Utilisez Get-powerpivotserviceapplication pour obtenir une identité valide.

Exemple 3

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

Cet exemple montre comment définir les heures de début et de fin d'une journée de travail, utilisées comme option de planification pour planifier l'actualisation des données PowerPivot. Les planifications peuvent spécifier une option après les heures de travail pour l'exécution de l'actualisation des données à la fin d'un journée de travail.

Utilisez Get-powerpivotserviceapplication pour obtenir une identité valide.