Partager via


Configuration de la gestion des hôtes de flux de travail à l'aide des cmdlets de Windows Server AppFabric

Cette rubrique décrit la configuration des fonctionnalités liées à l'hébergement à l'aide des cmdlets Windows PowerShell de AppFabric.

Configuration de la fonctionnalité de déchargement des instances à l'aide de cmdlets

Cette section décrit l'utilisation des cmdlets de AppFabric pour obtenir, définir ou effacer les éléments et attributs de configuration liés à la fonctionnalité de déchargement des instances dans le fichier de configuration associé à l'étendue spécifiée. La fonctionnalité de déchargement des instances permet de spécifier la persistance et le déchargement des instances de service de flux de travail.

Cmdlet

Description

Get-ASInstanceUnloadPolicy

Obtient les valeurs des attributs timeToUnload et timeToPersist de l'élément workflowIdle dans le fichier de configuration associé à l'étendue spécifique.

Set-ASInstanceUnloadPolicy

Définit les valeurs des attributs timeToUnload et timeToPersist de l'élément workflowIdle dans le fichier de configuration associé à l'étendue spécifique. Si l'élément workflowIdle n'existe pas, la cmdlet ajoute l'élément et définit les valeurs des attributs timeToUnload et timeToPersist sur l'élément. Si vous transmettez un seul de ces deux paramètres, l'attribut correspondant à l'autre paramètre est défini sur 00:00:00.

Clear-ASInstanceUnloadPolicy

Supprime l'élément workflowIdle du fichier de configuration associé à l'étendue spécifiée.

Options de syntaxe de la cmdlet Get-ASInstanceUnloadPolicy

// to get instance unload policy settings at the root level
Get-ASInstanceUnloadPolicy -Root

// to get instance unload policy settings at the Web site level
Get-ASInstanceUnloadPolicy -SiteName <String> 

// to get instance unload policy settings at the virtual application or service level that the VirtualPath points to 
Get-ASInstanceUnloadPolicy -SiteName <String> -VirtualPath <String>] 

// to get instance unload policy settings at the site, virtual application or service level that the Uri points to
Get- ASInstanceUnloadPolicy -Uri <Uri> 

// to get instance unload policy settings at the application level specified by the ApplicationObject.
Get-ASInstanceUnloadPolicy -ApplicationObject <ApplicationInfo> 
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Get-ASInstanceUnloadPolicy

// to get instance unload policy settings at the service level specified by the Service Object
Get-ASInstanceUnloadPolicy -ServiceObject <ServiceInfo> 
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Get-ASInstanceUnloadPolicy

Options de syntaxe de la cmdlet Set-ASInstanceUnloadPolicy

Set-ASInstanceUnloadPolicy –Root –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy -SiteName <String> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy -SiteName <String> -VirtualPath <string> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy –Uri <Uri> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy –ApplicationObject <ApplicationInfo> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Set-ASInstanceUnloadPolicy –ServiceObject <ServiceInfo> –TimeToPersist <TimeSpan> -TimeToUnload <TimeSpan>

Paramètres spécifiques à la cmdlet Set-ASInstanceUnloadPolicy

Paramètre

Description

TimeToUnload

Spécifie le délai d'attente qu'un hôte de service doit respecter avant de décharger une instance de service de flux de travail après que celle-ci soit devenue inactive.

TimeToPersist

Spécifie le délai d'attente qu'un hôte de service doit respecter avant de rendre persistante une instance de service de flux de travail après que celle-ci soit devenue inactive.

Notes

Vous devez uniquement transmettre le paramètre que vous voulez modifier. Par exemple, si vous voulez définir la valeur de l'attribut timeToUnload, transmettez uniquement le paramètre TimeToUnload.

Options de syntaxe de la cmdlet Clear-ASInstanceUnloadPolicy

Clear-ASInstanceUnloadPolicy -Root

Clear-ASInstanceUnloadPolicy -SiteName <String> 

Clear-ASInstanceUnloadPolicy -SiteName <String> -VirtualPath <String>] 

Clear- ASInstanceUnloadPolicy -Uri <Uri> 

Clear-ASInstanceUnloadPolicy -ApplicationObject <ApplicationInfo> 
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Clear-ASInstanceUnloadPolicy

Clear-ASInstanceUnloadPolicy -ServiceObject <ServiceInfo> 
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Clear-ASInstanceUnloadPolicy

Configuration de la stratégie d'exception des instances à l'aide de cmdlets

Vous pouvez utiliser les cmdlets suivantes :

Cmdlet

Description

Get-ASInstanceExceptionPolicy

Obtient la valeur de l'attribut action de l'élément workflowUnhandledException dans le fichier de configuration associé à l'étendue spécifiée.

Set-ASInstanceExceptionPolicy

Définit la valeur de l'attribut action de l'élément workflowUnhandledException dans le fichier de configuration associé à l'étendue spécifiée. La cmdlet crée l'élément si celui-ci n'existe pas déjà, puis définit l'attribut action sur l'élément.

Clear-ASInstanceExceptionPolicy

Supprime l'élément workflowUnhandledException du fichier de configuration associé à l'étendue spécifiée.

Options de syntaxe de la cmdlet Get-ASInstanceExceptionPolicy

// to get instance exception policy settings at the root level
Get-ASInstanceExceptionPolicy -Root

// to get instance exception policy settings at the Web site level
Get-ASInstanceExceptionPolicy -SiteName <String> 

// to get instance exception policy settings at the virtual application or service level that the VirtualPath points to 
Get-ASInstanceExceptionPolicy -SiteName <String> -VirtualPath <String>] 

// to get instance exception policy settings at the site, virtual application or service level that the Uri points to
Get-ASInstanceExceptionPolicy -Uri <Uri> 

// to get instance exception policy settings at the application level specified by the ApplicationObject.
Get-ASInstanceExceptionPolicy -ApplicationObject <ApplicationInfo> 
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Get-ASInstanceExceptionPolicy

// to get instance exception policy settings at the service level specified by the Service Object
Get-ASInstanceExceptionPolicy -ServiceObject <ServiceInfo> 
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Get-ASInstanceExceptionPolicy

Avertissement

Le Gestionnaire des services Internet affiche la valeur AbandonAndSuspend pour ce champ s'il n'y a pas d'élément workflowUnhandledException dans le fichier de configuration associé à l'étendue spécifiée. Cette cmdlet ne renvoie aucune valeur s'il n'y a pas d'élément workflowUnhandledException dans le fichier de configuration associé à l'étendue spécifiée.

Options de syntaxe de la cmdlet Set-ASInstanceExceptionPolicy

Set-ASInstanceExceptionPolicy –Root –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy -SiteName <String> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy -SiteName <String> -VirtualPath <string> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy –Uri <Uri> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy –ApplicationObject <ApplicationInfo> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Set-ASInstanceExceptionPolicy –ServiceObject <ServiceInfo> –Action {Abandon | AbandonAndSuspend | Cancel | Terminate}

Paramètres spécifiques à la cmdlet Set-ASInstanceExceptionPolicy

Paramètre

Description

Action

Spécifie l'action que doit effectuer un hôte de service lorsqu'une instance de service de flux de travail qu'il exécute rencontre une exception non prise en charge.

  • Abandon. L'hôte de service abandonne l'instance de service de flux de travail en mémoire. L'état de l'instance dans la base de données reste « Actif ». Le service de gestion du flux de travail restaure l'instance de service de flux de travail abandonnée à partir du dernier point de persistance enregistré dans la base de données de persistance.

  • AbandonAndSuspend. L'hôte de service abandonne l'instance de service de flux de travail en mémoire et définit son état dans la base de données de persistance sur « Interrompu ». Une instance de service de flux de travail interrompue peut être reprise ou arrêtée ultérieurement à l'aide du Gestionnaire des services Internet. Ces instances ne sont pas automatiquement reprises par le service de gestion du flux de travail.

  • Terminate. L'hôte de service abandonne l'instance de service de flux de travail en mémoire et définit son état dans la base de données de persistance sur « Exécuté (Arrêté) ». Une instance de service de flux de travail arrêtée ne peut pas être reprise ultérieurement.

  • Cancel. L'hôte de service annule l'instance de service de flux de travail en mémoire, ce qui entraîne l'appel de tous les gestionnaires d'annulation de façon à ce qu'un flux de travail s'arrête normalement, puis définisse l'état de l'instance dans la base de données de persistance sur « Exécuté (Arrêté) ».

Options de syntaxe de la cmdlet Clear-ASInstanceExceptionPolicy

Clear-ASInstanceExceptionPolicy -Root

Clear-ASInstanceExceptionPolicy -SiteName <String> 

Clear-ASInstanceExceptionPolicy -SiteName <String> -VirtualPath <String>] 

Clear-ASInstanceExceptionPolicy -Uri <Uri> 

Clear-ASInstanceExceptionPolicy -ApplicationObject <ApplicationInfo> 

Clear-ASInstanceExceptionPolicy -ServiceObject <ServiceInfo> 

Configuration de la stratégie de gestion des instances à l'aide de cmdlets

Vous pouvez utiliser les cmdlets suivantes :

Cmdlet

Description

Get-ASInstanceManagement

Obtient la valeur de l'attribut authorizedWindowsGroup de l'élément workflowInstanceManagement dans le fichier de configuration associé à l'étendue spécifiée.

Set-ASInstanceManagement

Définit la valeur de l'attribut authorizedWindowsGroup de l'élément workflowInstanceManagement dans le fichier de configuration associé à l'étendue spécifiée. La cmdlet crée l'élément si celui-ci n'existe pas déjà, puis définit l'attribut action sur l'élément.

Clear-ASInstanceManagement

Supprime l'élément workflowInstanceManagement du fichier de configuration associé à l'étendue spécifiée. La cmdlet ajoute également <remove name="workflowInstanceManagement" /> au fichier de configuration.

Options de syntaxe de la cmdlet Get-ASInstanceManagement

// to get instance management policy settings at the root level
Get-ASInstanceManagement -Root

// to get instance management policy settings at the Web site level
Get-ASInstanceManagement -SiteName <String> 

// to get instance management policy settings at the virtual application or service level that the VirtualPath points to 
Get-ASInstanceManagement -SiteName <String> -VirtualPath <String>] 

// to get instance management policy settings at the site, virtual application or service level that the Uri points to
Get-ASInstanceManagement -Uri <Uri> 

// to get instance management policy settings at the application level specified by the ApplicationObject.
Get-ASInstanceManagement -ApplicationObject <ApplicationInfo> 
// Ex: Get-ASApplication -SiteName "Default Web Site" -VirtualPath /SampleApp | Get-ASInstanceManagement

// to get instance management policy settings at the service level specified by the Service Object
Get-ASInstanceManagement -ServiceObject <ServiceInfo> 
// Ex: Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Get-ASInstanceManagement

Options de syntaxe de la cmdlet Set-ASInstanceManagement

Set-ASInstanceManagement –Root –AuthorizedWindowsGroup <String>}

Set-ASInstanceManagement -SiteName <String> –AuthorizedWindowsGroup <String>}

Set-ASInstanceManagement -SiteName <String> -Virtual Path <String> –AuthorizedWindowsGroup <String>}
Set-ASInstanceManagement -SiteName <String> -Virtual Path <String> –Root –EnableNetPipeProtocol
Set-ASInstanceManagement -SiteName <String> -Virtual Path <String> –AuthorizedWindowsGroup <String>} –Root –EnableNetPipeProtocol

Set-ASInstanceManagement –Uri <Uri> –AuthorizedWindowsGroup <String>}

Set-ASInstanceManagement –ApplicationObject <ApplicationInfo> –AuthorizedWindowsGroup <String>}

Set-ASInstanceManagement –ServiceObject <ServiceInfo> –AuthorizedWindowsGroup <String>}

Options de syntaxe de la cmdlet Clear-ASInstanceManagement

Clear-ASInstanceManagement -Root

Clear-ASInstanceManagement -SiteName <String> 

Clear-ASInstanceManagement -SiteName <String> -VirtualPath <String>] 

Clear-ASInstanceManagement -Uri <Uri> 

Clear-ASInstanceManagement -ApplicationObject <ApplicationInfo> 

Clear-ASInstanceManagement -ServiceObject <ServiceInfo> 

  2011-12-05