Partager via


Configuration du cache à l'aide de Windows PowerShell (mise en cache d'AppFabric 1.1)

Vous pouvez configurer le service de Mise en cache de Microsoft AppFabric 1.1 pour Windows Server de deux façons : via l'interface utilisateur de l'Assistant Configuration d'AppFabric et grâce à un ensemble de commandes Windows PowerShell pour la Mise en cache d'AppFabric. Cette rubrique décrit les commandes Windows PowerShell. Pour plus d'informations sur l'utilisation de l'Assistant Configuration d'AppFabric, consultez la rubrique Configuration d'AppFabric.

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. Vous devez ensuite importer manuellement le module Windows PowerShell qui contient les commandes de configuration, comme illustré dans l’exemple suivant.

Import-Module DistributedCacheConfiguration

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.

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 de configuration :

get-command -module DistributedCacheConfiguration

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 Add-CacheHost :

get-help Add-CacheHost -full

Commandes de configuration

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 de configuration. Pour plus d'informations sur les commandes d'administration, consultez la rubrique Utilisation de Windows PowerShell pour la gestion des fonctionnalités de mise en cache d'AppFabric 1.1. Le tableau suivant répertorie les commandes Windows PowerShell qui permettent de configurer le service de mise en cache.

Commande (RTM) Commande (QFE) Description

Add-CacheAdmin

Add-AFCacheAdminLocalConfiguration

Configure l'administration du cache sur l'hôte de cache. Cette commande opère sur le serveur localement.

Add-CacheHost

Add-AFCacheHostLocalConfiguration

Configure un hôte de cache pour l'activer et le joindre à un cluster existant. Cette commande opère sur le serveur localement.

Get-CacheClusterInfo

Get-AFCacheCluster

Renvoie des informations sur le cluster de cache, notamment sur son état d'initialisation et sa taille.

Get-CacheConnectionString

Get-AFCacheTemporaryConnectionString

Renvoie la chaîne de connexion temporaire définie à l'aide de la commande Set-CacheConnectionString. Notez que cette commande n'indique pas nécessairement la chaîne de connexion utilisée par le magasin de configuration du cluster de cache.

Notes

Cette commande est utilisée en interne par Microsoft AppFabric 1.1 pour Windows Server. Aucun scénario d'utilisateur connu ne requiert son utilisation.

New-CacheCluster

New-AFCacheClusterConfiguration

Crée et initialise un magasin de configuration du cluster de cache.

Register-CacheHost

Register-AFCacheHost

Ajoute un hôte de cache au magasin de configuration du cluster de cache spécifié.

Remove-CacheAdmin

Remove-AFCacheAdminLocalConfiguration

Annule la configuration de l'administration du cache sur l'hôte de cache. Cette commande opère sur le serveur localement.

Remove-CacheCluster

Remove-AFCacheClusterConfiguration

Supprime une configuration de cluster existante.

Remove-CacheHost

Remove-AFCacheHost

Annule la configuration d'un hôte de cache ne faisant pas actuellement partie d'un cluster de cache. Cette commande opère sur le serveur localement.

Set-CacheConfigurationLog

Set-AFCacheConfigurationLogging

Définit un emplacement de fichier journal à utiliser pour la journalisation des commandes de configuration. Par défaut, les journaux sont placés dans le dossier Temp.

Set-CacheConnectionString

Set-AFCacheTemporaryConnectionString

Rend la chaîne de connexion persistante pour un usage temporaire. La chaîne peut être récupérée par la suite à l'aide de la commande Get-CacheConnectionString. Notez que cette commande ne modifie pas la chaîne de connexion utilisée par le magasin de configuration du cluster de cache.

Notes

Cette commande est utilisée en interne par Microsoft AppFabric 1.1 pour Windows Server. Aucun scénario d'utilisateur connu ne requiert son utilisation.

Test-CacheClusterConnection

Test-AFCacheClusterConnection

Teste la connexion à un magasin de configuration du cluster de cache.

Unregister-CacheHost

Unregister-AFCacheHost

Supprime une entrée d'hôte de cache du magasin de configuration du cluster de cache. Si l'enregistrement de l'hôte actuel est en cours d'annulation, le paramètre HostName n'est pas requis. Dans ce cas, les paramètres Provider et ConnectionString sont également facultatifs, en supposant que l'hôte de cache actuel est configuré et que la commande Remove-CacheHost n'a pas été appelée sur l'hôte de cache.

Avertissement

La commande Stop-CacheHost doit être appelée pour arrêter un hôte de cache avant d'annuler son enregistrement. Si ce n'est pas le cas, cela peut provoquer le blocage du service.

Voir aussi

Concepts

Utilisation de Windows PowerShell pour la gestion des fonctionnalités de 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