Configuration du suivi
Cette rubrique décrit l'utilisation des cmdlets de AppFabric pour configurer le suivi d'une application ou d'un service. Les cmdlets Import-ASAppServiceTrackingProfile, Get-ASAppServiceTracking, Remove-ASAppServiceTrackingProfile et Get-ASAppServiceTrackingProfile permettent de configurer la fonctionnalité de suivi.
Pour exécuter une cmdlet de AppFabric de manière interactive, 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.
Importation des informations de suivi pour une application
Dans la console Windows PowerShell, exécutez la cmdlet Import-ASAppServiceTrackingProfile pour configurer le suivi, qui est utilisé pour surveiller les opérations de service. Cette cmdlet importe un modèle de suivi du fichier spécifié vers le fichier de configuration cible du niveau spécifié. La cible (étendue) de cette opération peut être le fichier Machine.config, le fichier Web.config racine, ou un fichier Web.config avec un chemin spécifié par un site, une application, un répertoire virtuel d'application, un service ou une instance de service. Si un service est spécifié, il doit s'agir d'un service .svc, .xamlx ou .xoml.
Options de syntaxe de la cmdlet Import-ASAppServiceTrackingProfile :
Syntaxe 1
Import-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-FilePath] <String> [-Overwrite] [-ProfileName <String>]
Syntaxe 2
Import-ASAppServiceTrackingProfile [-Uri] <Uri> [-FilePath] <String> [-Overwrite] [-ProfileName <String>]
Syntaxe 3
Import-ASAppServiceTrackingProfile [-FilePath] <String> -ApplicationObject <ApplicationInfo> [-Overwrite] [-ProfileName <String>]
Syntaxe 4
Import-ASAppServiceTrackingProfile [-FilePath] <String> -ServiceObject <ServiceInfo> [-Overwrite] [-ProfileName <String>]
Syntaxe 5
Import-ASAppServiceTrackingProfile [-FilePath] <String> [-Overwrite] [-ProfileName <String>] -Root
| Paramètre | Description |
|---|---|
[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo> ou -Root |
Étendue opérationnelle de la cmdlet |
[-FilePath] <String> |
Spécifie le nom du fichier (chemin d'accès compris) depuis lequel importer le modèle de suivi. Ce paramètre est obligatoire. Le fichier doit contenir un modèle. |
[-Overwrite] |
Ce paramètre est facultatif. S'il est spécifié, la configuration de modèle de suivi existante est remplacée. Ce comportement revient à appeler la cmdlet Remove-TrackingProfile suivie de la cmdlet Import-TrackingParticipant sans l'indicateur -overwrite. La cmdlet échoue si le modèle de suivi ne peut pas être supprimé. |
[-ProfileName <String>] |
Spécifie le nom à affecter au modèle de suivi importé. Il spécifie l'attribut de nom de l'élément de modèle. Ce paramètre est facultatif. S'il est spécifié, il remplace le nom spécifié dans le fichier. |
Obtention des informations de suivi pour une application
Dans la console Windows PowerShell, exécutez la cmdlet Get-ASAppServiceTracking pour obtenir les paramètres de suivi actuels pour un service à l'aide d'un objet ServiceTrackingInfo qui décrit les paramètres de suivi actuels pour le service. L'objet contient la liste des composants de suivi activés pour le service et un indicateur spécifiant si le suivi est activé sur le service. La cible (étendue) de cette opération est le fichier Web.config associé à un service (ou une instance de service).
Options de syntaxe de la cmdlet Get-ASAppServiceTracking :
Syntaxe 1
Get-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>]
Syntaxe 2
Get-ASAppServiceTracking [-Uri] <Uri>
Syntaxe 3
Get-ASAppServiceTracking -ApplicationObject <ApplicationInfo>
Syntaxe 4
Get-ASAppServiceTracking -ServiceObject <ServiceInfo>
Syntaxe 5
Get-ASAppServiceTracking -Root
| Paramètre | Description |
|---|---|
[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo> ou -Root |
Étendue opérationnelle de la cmdlet |
Définition des informations de suivi pour une application
Dans la console Windows PowerShell, exécutez la cmdlet Set-AsAppServiceTracking pour définir les informations de suivi pour l'application Web sur l'étendue spécifiée.
Options de syntaxe de la cmdlet Set-AsAppServiceTracking :
Syntaxe 1
Set-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>
Syntaxe 2
Set-ASAppServiceTracking [-Uri] <Uri> -ProfileName <String>
Syntaxe 3
Set-ASAppServiceTracking -ApplicationObject <ApplicationInfo> -ProfileName <String>
Syntaxe 4
Set-ASAppServiceTracking -ProfileName <String> -ServiceObject <ServiceInfo>
Syntaxe 5
Set-ASAppServiceTracking -ProfileName <String> -Root
| Paramètre | Description |
|---|---|
[-SiteName] <String> [[-VirtualPath], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo> ou -Root |
Étendue opérationnelle de la cmdlet |
-ProfileName |
Nom du modèle contenant les informations de suivi à définir |
Suppression des informations de suivi pour une application
Dans la console Windows PowerShell, exécutez la cmdlet Remove-ASAppServiceTrackingProfile pour supprimer un modèle de suivi du niveau spécifié de la configuration. Cette cmdlet permet de configurer le suivi, qui est utilisé pour surveiller les opérations de service.
Options de syntaxe de la cmdlet Remove-ASAppServiceTrackingProfile :
Syntaxe 1
Remove-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>
Syntaxe 2
Remove-ASAppServiceTrackingProfile [-Uri] <Uri> -ProfileName <String>
Syntaxe 3
Remove-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> -ProfileName <String>
Syntaxe 4
Remove-ASAppServiceTrackingProfile -ProfileName <String> -ServiceObject <ServiceInfo>
Syntaxe 5
Remove-ASAppServiceTrackingProfile -ProfileName <String> -Root
| Paramètre | Description |
|---|---|
[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo> ou -Root |
Étendue opérationnelle de la cmdlet |
-ProfileName <String> |
Spécifie le nom du modèle de suivi à supprimer. Le modèle doit être défini localement dans le fichier de configuration cible. Ce paramètre est obligatoire. |
Obtention d'un modèle de suivi pour une application
Dans la console Windows PowerShell, exécutez la cmdlet Get-ASAppServiceTrackingProfile pour renvoyer les modèles de suivi visibles pour un service (notamment les modèles définis sur toutes les étendues) dans une classe TrackingProfileInfo. Tous les paramètres dans la hiérarchie de configuration du fichier de configuration cible sont dans l'étendue pour cette opération. Celle-ci peut donc renvoyer des paramètres locaux (définis dans le fichier cible) et hérités (définis dans le fichier Machine.config ou le fichier Web.config racine).
Options de syntaxe de la cmdlet Get-ASAppServiceTrackingProfile :
Syntaxe 1
Get-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-ProfileName <String>]
Syntaxe 2
Get-ASAppServiceTrackingProfile [-Uri] <Uri> [-ProfileName <String>]
Syntaxe 3
Get-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> [-ProfileName <String>]
Syntaxe 4
Get-ASAppServiceTrackingProfile -ServiceObject <ServiceInfo> [-ProfileName <String>]
Syntaxe 5
Get-ASAppServiceTrackingProfile [-ProfileName <String>] -Root
| Paramètre | Description |
|---|---|
[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo> ou -Root |
Étendue opérationnelle de la cmdlet |
-ProfileName <String> |
Spécifie le nom du modèle de suivi à renvoyer. Le modèle peut être défini localement dans le fichier de configuration cible ou hérité de la hiérarchie de son fichier de configuration. Ce paramètre est facultatif. Si le paramètre ProfileName n'est pas spécifié, tous les modèles de suivi (locaux et hérités) associés au fichier de configuration cible sont renvoyés. |
2011-12-05