Affichage des services à l'aide des cmdlets de Windows Server AppFabric
Cette rubrique décrit l'affichage des services et des instances de service à l'aide de cmdlets de AppFabric.
Notes
Pour exécuter manuellement une cmdlet d'AppFabric, ouvrez la console Windows PowerShell pour AppFabric, entrez la cmdlet appropriée, puis appuyez sur Entrée. Pour plus d'informations sur l'exécution des cmdlets, consultez la rubrique Exécution des cmdlets de Windows Server AppFabric. Pour plus d'informations sur les classes et paramètres communs utilisés dans les instructions de syntaxe figurant dans ce document, consultez la rubrique Référence Windows PowerShell pour Windows Server AppFabric.
Obtention des services d'une d'application
La cmdlet Get-ASAppService affiche tous les services disponibles sur l'étendue spécifiée. Le tableau ci-dessous décrit les paramètres de cette cmdlet.
| Paramètre | Description |
|---|---|
-Root (facultatif) |
Si ce paramètre est spécifié, les paramètres –Uri, -SiteName et –ServiceObject ne doivent pas l'être. Lorsque vous utilisez ce paramètre, la cmdlet renvoie tous les services hébergés sur le serveur local dans l'environnement IIS/WAS. |
-SiteName (facultatif) |
Si ce paramètre est spécifié, les paramètres –Root, -Uri et –ServiceObject ne doivent pas l'être. Lorsque vous utilisez ce paramètre, la cmdlet renvoie tous les services hébergés sur le site Web spécifié. |
-VirtualPath (facultatif) |
Ce paramètre facultatif est utilisé avec le paramètre -SiteName, lorsque les paramètres -Uri et -ServiceObject ne sont pas spécifiés. Spécifie le chemin d'accès virtuel à un service ou une application (par exemple, /MyDir1/MyApp1/POService.svc). |
-Uri (facultatif) |
Si ce paramètre est spécifié, les paramètres -SiteName, -VirtualPath et -ServiceObject ne doivent pas l'être. Spécifie l'URI d'un site, d'une application ou d'un service. Si ce paramètre est spécifié, seuls les services disponibles sous cette URI sont renvoyés. |
-ApplicationObject (facultatif) |
Si ce paramètre est spécifié, les paramètres -SiteName, -VirtualPath et -Uri ne doivent pas l'être. Ce paramètre est généralement utilisé pour canaliser la sortie de la cmdlet Get-ASAppService. |
-Count (facultatif) |
Renvoie le nombre de services. |
Pour plus d'informations sur cette cmdlet, consultez la rubrique Get-ASAppService.
Obtention d'une instance de service
La cmdlet Get-ASAppServiceInstance affiche des informations sur les objets instance de service d'un ou plusieurs magasins de persistance. La cmdlet Get-ASAppServiceInstance interroge un ensemble spécifié de magasins de persistance et renvoie une série d'instances de service qui correspondent aux paramètres de requête fournis. Le tableau ci-dessous décrit les paramètres de cette cmdlet.
| Paramètre | Description |
|---|---|
-Root (facultatif) |
Si ce paramètre est spécifié, les paramètres –Uri, -SiteName et –ServiceObject ne doivent pas l'être. Lorsque vous utilisez ce paramètre, la cmdlet renvoie toutes les instances de service sur le serveur local. |
-SiteName (facultatif) |
Si ce paramètre est spécifié, les paramètres -Uri et -ServiceObject ne doivent pas l'être. Spécifie le nom d'un site. Si ce paramètre est spécifié, seules les instances des services hébergés dans le site spécifié sont renvoyées. |
-VirtualPath (facultatif) |
Ce paramètre facultatif est utilisé avec le paramètre -SiteName, lorsque les paramètres -Uri et -ServiceObject ne sont pas spécifiés. Spécifie le chemin d'accès virtuel à un service ou une application (par exemple, /MyDir1/MyApp1/POService.svc). |
-Uri (facultatif) |
Si ce paramètre est spécifié, les paramètres -SiteName, -VirtualPath et -ServiceObject ne doivent pas l'être. Spécifie l'URI d'un site, d'une application ou d'un service. Si ce paramètre est spécifié, seules les instances de service sous cette URI sont renvoyées. |
-ServiceInfo (facultatif) |
Si ce paramètre est spécifié, les paramètres -SiteName, -VirtualPath et -Uri ne doivent pas l'être. Spécifie un objet ServiceInfo utilisé pour identifier les instances de service pour lesquelles renvoyer des informations. Ce paramètre est généralement utilisé pour canaliser la sortie de la cmdlet Get-ASAppService. |
-ApplicationInfo (facultatif) |
Si ce paramètre est spécifié, les paramètres -SiteName, -VirtualPath et -Uri ne doivent pas l'être. Spécifie un objet ApplicationInfo utilisé pour identifier les instances de service pour lesquelles renvoyer des informations. Ce paramètre est généralement utilisé pour canaliser la sortie de la cmdlet Get-ASApplication. |
-Count (facultatif) |
Spécifie que seul le nombre d'instances trouvées correspondant aux paramètres de requête doit être renvoyé. |
-CreatedTimeFrom (facultatif) |
Spécifie le début d'une plage horaire au cours de laquelle une instance de service a démarré pour la première fois. Si ce paramètre est spécifié, seules les instances qui ont démarré au moment de l'horodatage ou après sont renvoyées. |
-CreatedTimeTo (facultatif) |
Spécifie la fin d'une plage horaire au cours de laquelle une instance de service a démarré pour la première fois. Si ce paramètre est spécifié, seules les instances qui ont démarré au moment de l'horodatage ou avant sont renvoyées. |
-MachineName (facultatif) |
Spécifie un nom d'ordinateur. Si ce paramètre est spécifié, seules les instances de service verrouillées par cet ordinateur sont renvoyées. |
-ModifiedTimeFrom (facultatif) |
Spécifie le début d'une plage horaire au cours de laquelle une instance de service a été modifiée. Si ce paramètre est spécifié, seules les instances modifiées au moment de l'horodatage ou après sont renvoyées. |
-ModifiedTimeTo (facultatif) |
Spécifie la fin d'une plage horaire au cours de laquelle une instance de service a été modifiée. Si ce paramètre est spécifié, seules les instances modifiées au moment de l'horodatage ou avant sont renvoyées. |
-ExceptionName (facultatif) |
Spécifie une chaîne représentant le nom de type pleinement qualifié d'une exception .NET Framework. Si ce paramètre est spécifié, seules les instances de service arrêtées à cause de l'exception spécifiée sont renvoyées. |
-MaxRows (facultatif) |
Spécifie le nombre de lignes (instances de service) à renvoyer. |
-InstanceId (facultatif) |
Spécifie l'ID d'instance (spécifié comme GUID) de l'instance de service à renvoyer. L'ID d'instance identifie une instance de service de façon univoque. Si ce paramètre est spécifié, l'instance portant cet ID est renvoyée (si elle est présente). |
-ServiceType (facultatif) |
Spécifie un service par son type. Si ce paramètre est spécifié, seules les instances de ce type de service sont renvoyées. Le type de service peut être exprimé sous la forme d'un chemin d'accès complet ou partiel, ou sous celle d'un nom et d'un espace de noms .NET Framework complet ou partiel. Lorsque vous spécifiez un type de service par un espace de noms, vous devez utiliser le caractère « # » pour séparer le type de service de l'espace de noms. Par exemple, si le nom complet du service CLR .NET Framework est Contoso.Web.Sales.POService, la valeur du paramètre doit être « Contoso.Web.Sales#POService ». Vous ne pouvez pas spécifier explicitement des caractères génériques. En revanche, ce paramètre contient des caractères génériques (« * ») précédant et suivant la valeur fournie. Par exemple, « Contoso/Service.svc » est traité comme « *Contoso/Service.svc* » et « Sales#POService » comme « *Sales#POService* ». |
-Status (facultatif) |
Spécifie l'état de l'instance. Si ce paramètre est spécifié, la requête ne renvoie que les instances de service dans l'état spécifié. Les valeurs possibles sont les suivantes : En cours d'exécution, Interrompu et Exécuté. |
-Condition (facultatif) |
Spécifie la condition de l'instance. Si ce paramètre est spécifié, la requête ne renvoie que les instances de service dans la condition spécifiée. Les valeurs possibles sont les suivantes : Active, Idle, Exception, UserSuspension, Successful, Cancelled et Terminated. |
-GroupBy (facultatif) |
Spécifie un champ utilisé pour grouper les nombres d'instances de service renvoyés. Les valeurs possibles sont les suivantes : UniqueApplication, UniqueService, ServiceType, Exception, Status, Site et MachineName. |
-OrderBy (facultatif) |
Affiche les instances de service triées dans l'ordre décroissant de l'heure de dernière mise à jour. |
-ExcludeSubFolders (facultatif) |
Si ce paramètre est spécifié, les résultats relatifs aux instances de sous-applications sont exclus des résultats relatifs à l'application qui les contient. |
-Timeout (facultatif) |
Spécifie le délai pendant lequel la cmdlet attend la réponse de la base de données. Il s'agit d'une valeur de temps au format hh:mm:ss. La valeur minimale est 00:00:01 (1 seconde) et la valeur maximale est TimeSpan.MaxValue. Si vous omettez de définir cette valeur, elle est réglée par défaut sur 00:02:00 (2 minutes). |
-ReturnBinaryProperties (facultatif) |
Si ce paramètre est spécifié, renvoie le groupe de propriétés de métadonnées binaires de l'objet InstanceInfo renvoyé. |
Pour plus d'informations sur cette cmdlet, consultez la rubrique Get-ASAppServiceInstance.
2011-12-05