Administration du cache avec Windows PowerShell (AppFabric 1.1)

  • Article

Grâce à Windows PowerShell, vous pouvez administrer le cluster de cache, les hôtes de cache et le cache lui-même. Si vous utilisez un ordinateur sur lequel la fonctionnalité d'administration du cache est installée, vous pouvez ouvrir le menu Démarrer, cliquer sur Tous les programmes, Microsoft AppFabric 1.1 pour Windows Server, puis Windows PowerShell pour l'administration de la mise en cache.

Notes

Vous devez exécuter Windows PowerShell avec des privilèges d'administrateur pour que certaines commandes d'administration fonctionnent correctement. Pour le raccourci Windows PowerShell pour l'administration de la mise en cache, cliquez avec le bouton droit dessus et sélectionnez Exécuter en tant qu'administrateur.

Les commandes PowerShell de Mise en cache d'AppFabric appartiennent à deux catégories principales : commandes d'administration et commandes de configuration. Cette rubrique s'attache à décrire les seules commandes d'administration. Pour plus d'informations sur les commandes de configuration, consultez la rubrique Configuration du cache à l'aide de Windows PowerShell (mise en cache d'AppFabric 1.1). Les commandes d'administration sont divisées en catégories dans les tableaux de cette rubrique. Certaines commandes apparaissent dans plusieurs tableaux, avec différents paramètres selon qu'elles s'appliquent à l'une des quatre catégories de commandes :

  • Commandes liées au cluster de cache

  • Commandes liées à l'hôte de cache

  • Commandes liées au cache

  • Commandes de gestion de la console

Modifications du nom des commandes dans le Mise à jour de mars 2012 pour AppFabric 1.1

La mise à jour du Mise à jour de mars 2012 pour AppFabric 1.1 incluait des modifications de nom apportées aux commandes Windows PowerShell pour AppFabric. Celles-ci améliorent la compréhension et la cohérence des commandes. Les tableaux suivants incluent le nom de commande d'origine (RTM) et le nom de la commande en mars 2012 (QFE).

Afin de conserver la compatibilité descendante, un script PowerShell a été fourni pour que les nouvelles commandes disposent d'un alias avec leur ancien nom. Toutes les modifications dans les noms de paramètres possèdent un alias au sein du module PowerShell.

Accès à l'aide dans la session Windows PowerShell

Les informations ci-dessous récapitulent les commandes d'administration des fonctionnalités de mise en cache d'AppFabric. Vous pouvez également obtenir de l'aide dans la session Windows PowerShell. Par exemple, la commande suivante affiche toutes les commandes d'administration :

get-command -module DistributedCacheAdministration

Si vous avez besoin d'aide sur une commande précise, vous pouvez utiliser la commande get-help pour la rechercher. Par exemple, la commande suivante affiche l'aide complète pour la commande New-Cache :

get-help New-Cache -full

Considérations importantes

Il convient de tenir compte des aspects suivants dans le cadre de l'utilisation des commandes Windows PowerShell décrites dans cette rubrique :

  • L'identité de sécurité de l'utilisateur des commandes Windows PowerShell doit disposer de privilèges d'administrateur sur tous les serveurs de cache dans le cluster de cache.

  • Les valeurs des paramètres des commandes respectent la casse. Par exemple, si vous créez le cache NamedCache1, la commande Get-CacheConfig -CacheName namedcache1 ne fonctionnera pas. Vous devez reproduire la casse comme suit : Get-CacheConfig -CacheName NamedCache1.

  • Lorsque vous modifiez la configuration du cluster à l'aide des commandes Export-CacheClusterConfig et Import-CacheClusterConfig, vous pouvez modifier les paramètres de configuration du cluster (attributs XML) dans le fichier XML, mais pas ajouter ou supprimer des caches nommés et des hôtes de cache en insérant ou en supprimant des éléments XML.

  • Les commandes de cluster de cache Start-CacheCluster, Stop-CacheCluster et Restart-CacheCluster impliquent une coordination de l'état du service Windows d'hôte de cache sur tous les serveurs de cache dans le cluster. L'exécution de ces commandes peut prendre davantage de temps lorsque les hôtes principaux exécutent le rôle de gestion du cluster. La majorité des hôtes principaux doit être en cours d'exécution lors de l'arrêt et du redémarrage des hôtes de cache restants.

  • Démarrez et arrêtez toujours le service de mise en cache à l'aide des commandes de cluster de cache Start-CacheCluster, Stop-CacheCluster et Restart-CacheCluster. L'utilisation de l'outil d'administration des services pour démarrer et arrêter le service peut entraîner un blocage. Par ailleurs, ces commandes doivent être exécutées à partir d'une session Windows PowerShell dotée de privilèges d'administrateur.

  • Les commandes de cluster de cache Stop-CacheCluster et Restart-CacheCluster purgent les données de la mémoire sur tous les hôtes de cache du cluster.

  • Les commandes Set-CacheConfig et Import-CacheClusterConfig nécessitent le redémarrage du cluster de cache à l'aide de la commande Restart-CacheCluster pour que les modifications prennent effet.

  • Les commandes Remove-Cache et New-Cache permettent de modifier la configuration d'un cache nommé sans affecter les autres caches nommés dans le cluster.

Commandes liées au cluster de cache

Le tableau suivant répertorie les commandes Windows PowerShell pour l'administration du cache qui permettent d'exécuter des opérations liées au cluster.

Commande (RTM) Commande (QFE) Description

Use-CacheCluster

Connect-AFCacheClusterConfiguration

Définit le contexte de votre session Windows PowerShell sur le cluster de cache souhaité.

Lorsque vous démarrez une session Windows PowerShell, vous devez commencer par exécuter cette commande. Si la session utilise un hôte de cache, exécutez la commande sans paramètres car ceux-ci sont extraits de la configuration du cache sur l'ordinateur. Si la session utilise un ordinateur non hôte, vous pouvez utiliser les paramètres suivants pour spécifier le cluster de cache souhaité.

Les paramètres sont décrits ci-dessous :

  • Provider : fournisseur utilisé pour stocker les paramètres de configuration du cluster. Ce paramètre peut avoir la valeur System.Data.SqlClient ou XML selon le mode de stockage des informations de configuration.

  • ConnectionString : chaîne de connexion de la base de données ou emplacement du fichier de configuration XML.

Start-CacheCluster

Start-AFCacheCluster

Démarre tous les services de cache dans le cluster. Les hôtes principaux sont démarrés en premier. Notez que les services cache ne sont pas démarrés automatiquement après un redémarrage : la commande Start-CacheCluster ou Start-CacheHost doit être appelée pour démarrer un service. Cette commande requiert des privilèges d'administrateur.

Stop-CacheCluster

Stop-AFCacheCluster

Arrête tous les services de cache dans le cluster. Cette commande requiert des privilèges d'administrateur.

Restart-CacheCluster

Restart-AFCacheCluster

Redémarre tous les services de cache dans le cluster selon la séquence appropriée. Cette commande requiert des privilèges d'administrateur.

Get-CacheClusterHealth

Get-AFCacheClusterHealth

Renvoie les statistiques relatives au fonctionnement du cluster de cache.

Export-CacheClusterConfig

Export-AFCacheClusterConfiguration

Conçue pour être utilisée avec la commande Import-CacheClusterConfig, cette commande permet de modifier les paramètres de configuration du cluster dans le fichier XML associé. Pour plus d'informations, voir Modification des paramètres de configuration du cluster.

Cette commande exporte les paramètres de configuration du cluster, tels qu'ils existent dans le cluster, vers le fichier de configuration XML spécifié. Cette commande peut être utilisée quel que soit l'emplacement de stockage des paramètres de configuration de votre cluster (SQL Server ou dossier réseau partagé).

Les paramètres sont décrits ci-dessous :

  • File : nom et chemin d'accès complets du fichier de configuration XML à créer, décrivant les paramètres actuels de configuration du cluster de cache.

Exemple : Export-CacheClusterConfig -File c:\Temp\CurrentClusterConfig.xml

Import-CacheClusterConfig

Import-AFCacheClusterConfiguration

Conçue pour être utilisée avec la commande Export-CacheClusterConfig, cette commande permet de modifier les paramètres de configuration du cluster dans le fichier XML associé. Pour plus d'informations, voir Modification des paramètres de configuration du cluster.

Cette commande importe les paramètres de configuration du cluster tels que définis dans le fichier de configuration XML spécifié. Cette commande peut être utilisée quel que soit l'emplacement de stockage des paramètres de configuration de votre cluster (SQL Server ou dossier réseau partagé).

Vous devez redémarrer le cluster à l'aide de la commande Restart-CacheCluster pour que les modifications prennent effet.

Les paramètres sont décrits ci-dessous :

  • File : nom et chemin d'accès complets du fichier de configuration XML décrivant les paramètres de configuration du cluster de cache à appliquer au cluster.

  • Force : importe le fichier de configuration sans demander de confirmation.

  • RefreshNow : modifie les paramètres de configuration du cluster de cache en cours d'exécution. Ceci ne fonctionne qu'avec les paramètres liés à la gestion de la mémoire pour le moment. Les hôtes de cache individuels doivent toutefois être redémarrés ou ajoutés au cluster pour que les paramètres de gestion de la mémoire prennent effet.

Exemple : Import-CacheClusterConfig -File c:\CurrentClusterConfig.xml

Grant-CacheAllowedClientAccount

Grant-AFCacheAllowedClientAccount

Octroie à un compte Windows l'accès au cluster de cache. Par défaut, les comptes d'administrateur sur les hôtes de cache ont accès au cluster de cache. Les autres comptes doivent être ajoutés de manière explicite à la liste des comptes clients autorisés à l'aide de cette commande.

Les paramètres sont décrits ci-dessous :

  • Account : compte Windows auquel octroyer l'accès au cluster de cache.

  • Force : ajoute le compte client spécifié sans valider son existence.

Revoke-CacheAllowedClientAccount

Revoke-AFCacheAllowedClientAccount

Révoque l'accès d'un compte Windows au cluster de cache. Notez que ceci n'empêche pas les administrateurs sur les hôtes de cache d'accéder au cluster de cache.

Les paramètres sont décrits ci-dessous :

  • Account : compte Windows auquel octroyer l'accès au cluster de cache.

Get-Cache

Get-AFCache

Lorsque cette commande est utilisée sans paramètres, elle répertorie les informations sur tous les caches dans le cluster de cache.

Notes

Pour plus d'informations sur l'utilisation de cette commande avec le paramètre HostName, consultez le tableau suivant.

Update-CacheHostAllowedVersions

Update-AFCacheHostAllowedVersions

Met à jour les plages de versions des hôtes de cache et clients de cache autorisés à accéder au cluster de cache. À l'heure actuelle, les numéros correspondent aux versions suivantes :

  • 1 = Windows Server AppFabric v1.0

  • 3 = Microsoft AppFabric 1.1 pour Windows Server

Les paramètres sont décrits ci-dessous :

  1. BeginClientVersion : première valeur de la plage de versions des clients de cache.

  2. EndClientVersion : dernière valeur de la plage de versions des clients de cache.

  3. BeginServerVersion : première valeur de la plage de versions des hôtes de cache.

  4. EndServerVersion : dernière valeur de la plage de versions des hôtes de cache.

Pour plus d'informations, consultez la rubrique Procédure de mise à niveau d'un cluster de cache AppFabric (AppFabric 1.1).

Stop-CacheNonUpdatedHosts

Stop-AFCacheNonUpdatedHosts

Arrête les hôtes de cache dont la version diffère des valeurs de version spécifiées.

Les paramètres sont décrits ci-dessous :

  1. BeginServerVersion : première valeur de la plage de versions des hôtes de cache.

  2. EndServerVersion : dernière valeur de la plage de versions des hôtes de cache.

  3. HostTimeout : délai d'attente en secondes de l'arrêt de chaque hôte.

  4. Version : version du code de l'hôte de cache.

Pour plus d'informations, consultez la rubrique Procédure de mise à niveau d'un cluster de cache AppFabric (AppFabric 1.1).

Update-CacheConfigurationStore

Update-AFCacheConfigurationStore

Met à jour le magasin de configuration du cache après la mise à niveau d'AppFabric. Dans le cadre de la mise à niveau vers Microsoft AppFabric 1.1 pour Windows Server, cette commande traduit les noms d'hôte de cache pour utiliser leur nom de domaine complet (FQDN) équivalent.

Commandes liées à l'hôte de cache

Le tableau suivant répertorie les commandes pour l'exécution des opérations liées à l'hôte de cache dans Windows PowerShell.

Commande (RTM) Commande (QFE) Description

Get-CacheHost

Get-AFCacheHost

Répertorie les informations relatives à l'hôte de cache spécifié. Si aucun paramètre n'est transmis, la commande répertorie tous les services cache appartenant au cluster de cache. L'état Shutting Down indique qu'un arrêt correct est en cours.

Les paramètres sont décrits ci-dessous :

  • HostName : nom de l'hôte de cache.

  • CachePort : numéro de port de cache de l'hôte de cache.

Exemple : Get-CacheHost

Get-CacheHostConfig

Get-AFCacheHostConfiguration

Renvoie les informations de configuration relatives à l'hôte de cache spécifié.

Les paramètres sont décrits ci-dessous :

  • HostName : nom de l'hôte de cache.

  • CachePort : numéro de port de cache de l'hôte de cache.

Exemple : Get-CacheConfig -HostName CacheServer1 -CachePort 22233

Set-CacheHostConfig

Set-AFCacheHostConfiguration

Met à jour la configuration de l'hôte de cache avec les valeurs spécifiées dans les paramètres de la commande. Tous les paramètres sont facultatifs à l'exception de HostName et CachePort. Pour plus d'informations, voir Modification des paramètres de configuration du cluster.

Les paramètres sont décrits ci-dessous :

  • HostName : nom de l'hôte de cache.

  • CachePort : numéro de port de cache actuel de l'hôte de cache.

  • ClusterPortNumber : numéro de port de cluster utilisé par l'hôte de cache.

  • ArbitratorPortNumber : nouveau numéro de port d'arbitrage.

  • ReplicationPortNumber : nouveau numéro de port de réplication.

  • CacheSize : quantité de mémoire allouée au stockage des données sur l'hôte de cache, en mégaoctets (Mo).

  • IsLeadHost : état de l'hôte principal pour l'hôte de cache (« true » ou « false »).

  • HWM : pourcentage de la limite supérieure de mémoire, lorsque l'éviction doit commencer à supprimer les objets non encore expirés.

  • LWM : pourcentage de la limite inférieure de mémoire, lorsque l'éviction doit commencer à supprimer les objets expirés. Une fois la valeur du paramètre HWM atteinte, lorsque l'éviction doit arrêter de supprimer les objets non encore expirés.

Exemple : Set-CacheConfig -HostName CacheServer1 -CachePort 22233 -LowWM 80

Start-CacheHost

Start-AFCacheHost

Démarre le service cache spécifié. Cette commande est requise après le redémarrage d'un serveur de cache pour permettre au service cache de rejoindre un cluster de cache en cours d'exécution. Notez que si le cluster de cache est interrompu, vous devez utiliser la commande Start-CacheCluster. Par ailleurs, les services cache ne sont pas démarrés automatiquement après un redémarrage : la commande Start-CacheHost ou Start-CacheCluster doit être appelée pour démarrer un service.

Les paramètres sont décrits ci-dessous :

  • HostName : nom de l'hôte de cache.

  • CachePort : numéro de port de cache de l'hôte de cache.

  • HostTimeout : valeur de délai d'expiration en secondes pour le démarrage de l'hôte de cache spécifié. La valeur par défaut est 60 secondes.

Exemple : Start-CacheHost -HostName CacheServer1 -CachePort 22233

Stop-CacheHost

Stop-AFCacheHost

Arrête le service cache spécifié.

Notes

La commande Stop-CacheHost n'arrête pas un service Windows d'hôte de cache si celui-ci exécute le rôle de gestion du cluster. Par ailleurs, l'arrêt de l'hôte de cache provoque l'arrêt du cluster entier. Pour plus d'informations, consultez la rubrique Hôtes principaux et gestion du cluster (mise en cache d'AppFabric 1.1).

Les paramètres sont décrits ci-dessous :

  • HostName : nom de l'hôte de cache.

  • CachePort : numéro de port de cache de l'hôte de cache.

  • HostTimeout : valeur de délai d'expiration en secondes pour le démarrage de l'hôte de cache spécifié.

  • Graceful : spécifie l'initiation d'un arrêt correct. Ce type d'arrêt déplace les éléments de cache vers d'autres hôtes de cache avant l'arrêt du service de mise en cache. Cela évite de perdre des données et les clients de cache n'ont plus besoin de reconstituer ces éléments. Le cluster de cache peut être créé à l'aide de la commande New-CacheCluster avec l'option GracefulShutdownEnabled pour faire des arrêts corrects le comportement par défaut de la commande Stop-CacheHost. Le cluster de cache doit également spécifier l'option GracefulShutdownTimeout.

    Avertissement

    N'exécutez un arrêt correct que lorsque vous avez vérifié que les serveurs et la mémoire restante suffisent pour traiter les éléments de cache déplacés vers les serveurs en cours d'exécution. Sinon, l'arrêt correct peut être bloqué et doit être annulé.

Exemple : Stop-CacheHost -HostName CacheServer1 -CachePort 22233

Stop-CacheHostShutdown

Stop-AFCacheHostShutdown

Annule un arrêt correct en cours. L'hôte de cache continue de s'exécuter et aucune donnée n'est perdue. Un équilibrage de charge normal peut suivre le cas échéant.

Les paramètres sont décrits ci-dessous :

  • HostName : nom de l'hôte de cache.

  • CachePort : numéro de port de cache de l'hôte de cache.

Restart-CacheHost

Restart-AFCacheHost

Redémarre le service de mise en cache spécifié. Les paramètres sont identiques à ceux de la commande Stop-CacheHost.

Get-CacheStatistics

Get-AFCacheStatistics

Affiche les statistiques relatives à l'hôte de cache spécifié, notamment la taille totale (en octets), et le nombre d'objets mis en cache, de régions, de caches nommés, de demandes et d'absences dans le cache.

Notes

Pour plus d'informations sur l'utilisation de cette commande avec le paramètre CacheName, consultez le tableau suivant.

Les paramètres sont décrits ci-dessous :

  • HostName : nom de l'hôte de cache.

  • CachePort : numéro de port de cache de l'hôte de cache.

Exemple : Get-CacheStatistics -HostName CacheServer1 -CachePort 22233

Get-Cache

Get-AFCache

Répertorie les caches et régions qui résident dans l'hôte de cache spécifié.

Les paramètres sont décrits ci-dessous :

  • HostName : nom de l'hôte de cache.

  • CachePort : numéro de port de cache de l'hôte de cache.

Exemple : Get-Cache -HostName CacheServer1 -CachePort 22233

Get-CacheRegion

Get-AFCacheRegion

Renvoie la liste des régions dans le cluster de cache. Seul le client de cache peut créer ou supprimer des régions. Le cluster de cache identifie l'hôte de cache sur lequel elles résideront. Tous les paramètres sont facultatifs.

Notes

Pour plus d'informations sur l'utilisation de cette commande avec le paramètre CacheName, consultez le tableau suivant.

Les paramètres sont décrits ci-dessous :

  • MaxRegions : nombre maximal de régions à afficher. Cette commande ne peut pas être utilisée avec le paramètre MaxRegionsPerHost.

  • MaxRegionsPerHost : nombre maximal de régions à afficher pour chaque hôte dans le cluster de cache.

Exemple : Get-CacheRegion -MaxRegionsPerHost 4

Commandes liées au cache

Le tableau suivant répertorie les commandes pour l'exécution des opérations liées au cache dans Windows PowerShell.

Commande (RTM) Commande (QFE) Description

New-Cache

New-AFCache

Crée un nouveau cache nommé lorsque le cluster est exécuté. Toutes les valeurs sont facultatives, à l'exception de CacheName.

Notes

Il peut y avoir jusqu'à 128 caches nommés.

Les paramètres sont décrits ci-dessous :

  • CacheName : nom du cache.

  • Secondaries : la valeur 1 active la fonctionnalité de haute disponibilité, tandis que la valeur 0 la désactive. La valeur par défaut est 0.

  • NotificationsEnabled : la valeur True active la fonctionnalité de notifications de cache, tandis que la valeur False la désactive.

  • Eviction : la valeur LRU active l'éviction LRU (dernier récemment utilisé), tandis que la valeur None la désactive. La valeur par défaut est LRU.

    Avertissement

    La valeur None peut saturer la mémoire de l'hôte de cache.

  • TimeToLive : délai d'expiration par défaut des objets stockés dans le cache avant leur expiration, en minutes. La valeur par défaut est 10.

  • Expirable : la valeur True active l'expiration, tandis que la valeur False la désactive. La valeur par défaut est True.

  • MinSecondaries : nombre minimal de copies secondaires d'un élément requises pour que les opérations d'écriture sur cet élément réussissent. La valeur par défaut est 0.

  • WriteBehindEnabled : active la fonction d'écriture. La valeur par défaut est false.

  • WriteBehindInterval : délai en secondes après lequel un élément de cache écrit sur le cache doit être écrit sur le fournisseur. La valeur minimale est 60 et la valeur par défaut 300.

  • WriteBehindRetryInterval : intervalle en secondes entre les nouvelles tentatives en cas d'échec de la connexion au fournisseur d'écriture. La valeur par défaut est 60 (valeur minimale).

  • WriteBehindRetryCount : nombre maximal de tentatives de connexion au fournisseur d'écriture. La valeur par défaut est -1 (nombre illimité de tentatives).

  • ReadThroughEnabled : active la fonction d'écriture. La valeur par défaut est false.

  • Provider Type : nom complet du type d'assembly du fournisseur. Ce fournisseur implémente les fonctions d'écriture et de lecture. Le nom respecte la casse. Par exemple : RTProvider.Provider, RTProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=80e2cb5f6ba933f0.

  • ProviderSettings : une ou plusieurs paires clé/valeur spécifiant les informations de connexion du fournisseur. Par exemple : @{"setting1"="value1";"setting2"="value2"}.

Exemple : New-Cache -CacheName NamedCache1 -Secondaries 1 -TimeToLive 15

Remove-Cache

Remove-AFCache

Supprime un cache nommé, comme spécifié par le paramètre CacheName.

Les paramètres sont décrits ci-dessous :

  • CacheName : nom du cache.

Exemple : Remove-Cache -CacheName NamedCache1

Get-CacheConfig

Get-AFCacheConfiguration

Renvoie les détails de configuration du cache nommé spécifié par le paramètre CacheName.

Les paramètres sont décrits ci-dessous :

  • CacheName : nom du cache.

Exemple : Get-CacheConfig -CacheName NamedCache1

Set-CacheConfig

Set-AFCacheConfiguration

Met à jour les paramètres de configuration du cache nommé, comme spécifié par le paramètre CacheName.

Le cluster de cache peut être arrêté lorsque le paramètre CacheName est utilisé pour modifier le cache. Vous pouvez également utiliser les commandes Remove-Cache et New-Cache. Celles-ci permettent de modifier la configuration d'un cache nommé sans affecter les autres caches nommés dans le cluster par l'arrêt du cluster.

Pour plus d'informations, voir Modification des paramètres de configuration du cache avec Windows PowerShell.

Les paramètres sont décrits ci-dessous :

  • CacheName : nom du cache.

  • Secondaries : la valeur 1 active la fonctionnalité de haute disponibilité, tandis que la valeur 0 la désactive. La valeur par défaut est 0. Notez que cette fonctionnalité est uniquement prise en charge pour les hôtes de cache exécutant les éditions Enterprise ou DataCenter de Windows Server.

  • NotificationsEnabled : la valeur True active la fonctionnalité de notifications de cache, tandis que la valeur False la désactive.

  • Eviction : la valeur LRU active l'éviction LRU (dernier récemment utilisé), tandis que la valeur None la désactive. La valeur par défaut est LRU.

    Avertissement

    La valeur None peut saturer la mémoire de l'hôte de cache.

  • TimeToLive : délai d'expiration par défaut des objets stockés dans le cache avant leur expiration, en minutes. La valeur par défaut est 10.

  • Expirable : la valeur True active l'expiration, tandis que la valeur False la désactive. La valeur par défaut est True.

  • MinSecondaries : nombre minimal de copies secondaires d'un élément requises pour que les opérations d'écriture sur cet élément réussissent. La valeur par défaut est 0.

  • WriteBehindEnabled : active la fonction d'écriture. La valeur par défaut est false.

  • WriteBehindInterval : délai en secondes après lequel un élément de cache écrit sur le cache doit être écrit sur le fournisseur. La valeur minimale est 60 et la valeur par défaut 300.

  • WriteBehindRetryInterval : intervalle en secondes entre les nouvelles tentatives en cas d'échec de la connexion au fournisseur d'écriture. La valeur par défaut est 60 (valeur minimale).

  • WriteBehindRetryCount : nombre maximal de tentatives de connexion au fournisseur d'écriture. La valeur par défaut est -1 (nombre illimité de tentatives).

  • ReadThroughEnabled : active la fonction d'écriture. La valeur par défaut est false.

  • Provider Type : nom complet du type d'assembly du fournisseur. Ce fournisseur implémente les fonctions d'écriture et de lecture. Le nom respecte la casse. Par exemple : RTProvider.Provider, RTProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=80e2cb5f6ba933f0.

  • ProviderSettings : une ou plusieurs paires clé/valeur spécifiant les informations de connexion du fournisseur. Par exemple : @{"setting1"="value1";"setting2"="value2"}.

  • RefreshNow : met à jour les paramètres de lecture et d'écriture sur un cluster de cache en cours d'exécution. Les autres paramètres ne peuvent pas être mis à jour avec ce commutateur.

Exemple : Set-CacheConfig -CacheName NamedCache1 -TimeToLive 30

Get-CacheStatistics

Get-AFCacheStatistics

Renvoie les statistiques d'un cache nommé, comme spécifié par le paramètre CacheName.

Notes

Pour plus d'informations sur l'utilisation de cette commande avec les paramètres HostName et CachePort, consultez le tableau précédent.

Les paramètres sont décrits ci-dessous :

  • CacheName : nom du cache.

Exemple : Get-CacheStatistics -CacheName NamedCache1

Get-CacheRegion

Get-AFCacheRegion

Renvoie la liste des régions d'un cache nommé, comme spécifié par le paramètre CacheName. Seul le client de cache peut créer ou supprimer des régions. Le cluster de cache contrôle l'hôte de cache sur lequel les régions résident.

Notes

Pour plus d'informations sur l'utilisation de cette commande avec les paramètres HostName et CachePort, consultez le tableau précédent.

Les paramètres sont décrits ci-dessous :

  • CacheName : nom du cache.

Exemple : Get-CacheRegion -CacheName NamedCache1

Commandes de gestion de la console

Le tableau suivant répertorie les commandes pour l'exécution des opérations de gestion de l'outil d'administration du cache basé sur Windows PowerShell.

Commande (RTM) Commande (QFE) Description

Set-CacheLogging

Set-AFCacheLogging

Cette commande active la journalisation basée sur des fichiers pour la session de l'outil d'administration du cache basé sur Windows PowerShell. Le suivi des événements initié par cette commande ne dure que le temps de la session Windows PowerShell depuis laquelle il a été appelé.

Par défaut, la journalisation est activée au niveau VERBOSE. Le fichier journal par défaut se trouve dans le répertoire%temp%. Son nom est constitué du préfixe DCacheAdministration, suivi de l'identificateur du processus et de l'horodatage de création.

Si un fichier du même nom existe déjà, Windows PowerShell tente de l'ajouter au fichier journal.

Les paramètres sont décrits ci-dessous :

  • LogLevel : niveau d'événement spécifiant les types d'événements capturés par le suivi. Les valeurs valides sont NONE, ERROR, WARNING, INFO et VERBOSE.

  • File : dossier ou chemin d'accès de fichier absolu dans lequel les journaux doivent être écrits. Si le nom du fichier n'est pas spécifié, il prend la valeur DCacheAdminTrace[<ProcessId>].log par défaut, où <ProcessId> correspond au numéro de l'ID de processus Windows de la session Windows PowerShell. ".log" est ajouté à tous les noms de fichier spécifiés.

Cet exemple crée le fichier c:\WarningLog.log qui capture les messages d'avertissement et d'erreur :

Set-CacheLogging -LogLevel WARNING -File c:\WarningLog

Cette commande suit les événements de la seule session Windows PowerShell, et non du client de cache ou de l'hôte de cache.

Clear-CacheLogging

Clear-AFCacheLogging

Arrête la journalisation commencée par la commande Set-CacheLogging.

Invoke-CacheGC

Invoke-AFCacheGarbageCollector

Appelle manuellement le nettoyage de la mémoire sur le cluster de cache pour libérer la mémoire inutilisée. Cette commande est uniquement disponible dans certaines circonstances. En général, le nettoyage de la mémoire est géré par .NET Framework et les fonctionnalités de gestion de la mémoire du cluster de cache d'AppFabric.

exit

exit

Ferme la session Windows PowerShell.

cls

cls

Efface l'écran Windows PowerShell.

Voir aussi

Concepts

Configuration du cache à l'aide de Windows PowerShell (mise en cache d'AppFabric 1.1)
Paramètres de configuration
Options de configuration de la mise en cache d'AppFabric
Dépannage de la mise en cache d'AppFabric
Concepts relatifs à la mise en cache d'AppFabric (mise en cache d'AppFabric 1.1)
Développement d'un client de cache

  2012-04-05