Compartilhar via

Configurar o Gerenciamento do Host de Fluxo de Trabalho usando cmdlets do Windows Server AppFabric

  • Artigo

Este tópico descreve como configurar recursos relacionados à hospedagem usando cmdlets AppFabric do Windows PowerShell.

Para configurar o recurso Descarga de Instância usando cmdlets

Esta seção descreve como usar cmdlets AppFabric para obter, definir ou limpar elementos e atributos de configuração relacionados ao recurso Descarga de Instância no arquivo de configuração associado ao escopo especificado. O recurso Descarga de Instância permite que você especifique se e quando as instâncias do serviço de fluxo de trabalho são persistentes e descarregadas.

Cmdlet

Descrição

Get-ASInstanceUnloadPolicy

Obtém os valores dos atributos timeToUnload e timeToPersist do elemento workflowIdle no arquivo de configuração associado ao escopo especificado.

Set-ASInstanceUnloadPolicy

Define os valores dos atributos timeToUnload e timeToPersist do elemento workflowIdle no arquivo de configuração associado ao escopo especificado. Se o elemento workflowIdle não existir, o cmdlet adicionará o elemento e definirá os valores dos atributos timeToUnload e timeToPersist no elemento. Se você passar somente um desses dois parâmetros, o atributo correspondente a outro parâmetro será definido como 00:00:00.

Clear-ASInstanceUnloadPolicy

Remove o elemento workflowIdle do arquivo de configuração associado ao escopo especificado.

Opções de sintaxe para o 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

Opções de sintaxe para o 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>

Parâmetros específicos para o cmdlet Set-ASInstanceUnloadPolicy

Parâmetro

Descrição

TimeToUnload

Especifica quanto tempo um host do serviço deve esperar antes de descarregar uma instância de serviço de fluxo de trabalho depois que a instância fica ociosa.

TimeToPersist

Especifica quanto tempo um host do serviço deve esperar antes de persistir uma instância de serviço de fluxo de trabalho depois que a instância fica ociosa.

Dica

Você só precisa passar o parâmetro que deseja alterar. Por exemplo, se você quiser definir um valor para o atributo timeToUnload, então passe somente o parâmetro TimeToUnload.

Opções de sintaxe para o 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

Para configurar a Diretiva de Exceção da Instância usando cmdlets

Você pode usar os seguintes cmdlets:

Cmdlet

Descrição

Get-ASInstanceExceptionPolicy

Obtém o valor do atributo action do workflowUnhandledException no arquivo de configuração associado ao escopo especificado.

Set-ASInstanceExceptionPolicy

Define o valor do atributo action do workflowUnhandledException no arquivo de configuração associado ao escopo especificado. O cmdlet criará o elemento se ele não existir e então definirá o atributo action no elemento.

Clear-ASInstanceExceptionPolicy

Remove o elemento workflowUnhandledException do arquivo de configuração associado ao escopo especificado.

Opções de sintaxe para o 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

Aviso

O Gerenciador do IIS exibirá AbandonAndSuspend como um valor para esse campo se não houver o elemento workflowUnhandledException associado no arquivo de configuração associado ao escopo especificado. No entanto, esse cmdlet não retornará nenhum valor se o elemento workflowUnhandledException não existir no arquivo de configuração associado ao escopo especificado.

Opções de sintaxe para o 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}

Parâmetros específicos para o cmdlet Set-ASInstanceExceptionPolicy

Parâmetro

Descrição

Ação

Especifica qual ação um host do serviço deverá executar quando uma instância de serviço de fluxo de trabalho executado enfrenta uma exceção sem tratamento.

  • Abandon. O host do serviço anula a instância de serviço de fluxo de trabalho na memória. O estado da instância no banco de dados permanece como “Ativo”. O Serviço de Gerenciamento de Fluxo de Trabalho recupera a instância de serviço de fluxo de trabalho abandonada a partir do último ponto de persistência salvo no banco de dados de persistência.

  • Abandon and suspend. O host do serviço anula a instância de serviço de fluxo de trabalho na memória e define o estado da instância como “Suspenso” no banco de dados de persistência. Uma instância de serviço de fluxo de trabalho suspensa pode ser retomada ou finalizada posteriormente usando o Gerenciador do IIS. Essas instâncias de serviço de fluxo de trabalho não são recuperadas automaticamente pelo Serviço de Gerenciamento de Fluxo de Trabalho.

  • Terminate. O host do serviço anula a instância de serviço de fluxo de trabalho na memória e define o estado da instância como “Concluído (Encerrado)” no banco de dados de persistência. Uma instância de serviço de fluxo de trabalho encerrada não pode ser retomada posteriormente.

  • Cancel. O host do serviço cancela a instância de serviço de fluxo de trabalho, o que faz com que todos os manipuladores de cancelamento sejam chamados para que um fluxo de trabalho seja encerrado de maneira amigável, e define o estado da instância como “Concluído (Cancelado)” no banco de dados de persistência.

Opções de sintaxe para o 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>

Para configurar a Diretiva de Gerenciamento da Instância usando cmdlets

Você pode usar os seguintes cmdlets:

Cmdlet

Descrição

Get-ASInstanceManagement

Obtém o valor do atributo authorizedWindowsGroup do workflowInstanceManagement no arquivo de configuração associado ao escopo especificado.

Set-ASInstanceManagement

Define o valor do atributo authorizedWindowsGroup do workflowInstanceManagement no arquivo de configuração associado ao escopo especificado. O cmdlet criará o elemento se ele não existir e então definirá o atributo action no elemento.

Clear-ASInstanceManagement

Remove o elemento workflowInstanceManagement do arquivo de configuração associado ao escopo especificado. O cmdlet também adiciona <remove name="workflowInstanceManagement" /> ao arquivo de configuração.

Opções de sintaxe para o 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

Opções de sintaxe para o 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>}

Opções de sintaxe para o 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