Configurar o Início automático usando Cmdlets do Windows Server AppFabric
Este tópico descreve como configurar o início automático de um aplicativo ou serviço usando cmdlets do AppFabric.
Para habilitar o início automático de um aplicativo
Para habilitar o início automático para serviços no aplicativo, no console do AppFabric Windows PowerShell, execute o cmdlet Set-ASApplication com o parâmetro -AutoStartMode definido como “All” ou “Custom”. A definição do parâmetro –AutoStartMode como “All” habilita o início automático para todos os serviços no aplicativo. A definição do parâmetro –AutoStartMode como “Custom” especifica que o início automático não está habilitado para nenhum serviço no aplicativo, a menos que ele esteja especificamente habilitado para o serviço (executando Enable-ASAppServiceAutoStart).
A habilitação do início automático para um aplicativo adiciona serviceAutoStartEnabled, definido com um valor “true”, ao arquivo applicationHost.config no nível do servidor. Habilitar o início automático de todos os serviços no aplicativo define o atributo serviceStartupMode do aplicativo no arquivo applicationHost.config a um valor “all”. Configurar o modo para “Personalizado” define o atributo serviceStartupMode a um valor “custom”.
Opções de sintaxe de Set-ASApplication:
Sintaxe 1
Set-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
Sintaxe 2
Set-ASApplication [-Uri] <Uri> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
Sintaxe 3
Set-ASApplication -ApplicationObject <ApplicationInfo> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName |
Nome do site do aplicativo WCF ou WF ao qual será habilitado o início automático. |
-VirtualPath |
Caminho virtual do aplicativo WCF ou WF ao qual será habilitado o início automático. |
-Uri |
Identificador de um serviço ou aplicativo específico. |
-ApplicationObject |
Nome de um objeto de aplicativo, que resulta no uso do arquivo Web.config correspondente como base de operação do cmdlet. |
–AutoStartMode <-All|-Custom> (opcional) |
Um valor “All” especifica que o início automático está habilitado para todos os serviços no aplicativo e que as definições de início automático do serviço específico serão ignoradas (comportamento padrão quando if–AutoStartMode não está incluído). Um valor “Custom” especifica que o início automático não está habilitado para nenhum serviço no aplicativo, a menos que ele esteja especificamente habilitado para o serviço. O modo de início automático de um serviço depende do modo de início automático de um aplicativo. |
–EnableApplicationPool (opcional) |
Habilita o início automático do pool de aplicativos usado pelo aplicativo. Define o atributo startMode do pool de aplicativos para “AlwaysRunning”. |
Para desabilitar o início automático de um aplicativo
Para desabilitar o início automático para serviços no aplicativo, no console do AppFabric Windows PowerShell, execute o cmdlet Set-ASApplication com o parâmetro -AutoStartMode definido como “Disable”. Essa ação exclui o atributo serviceAutoStartMode do arquivo applicationHost.config. Sem o atributo serviceStartupMode, o início automático será desabilitado.
Opções de sintaxe de Set-ASApplication:
Sintaxe 1
Set-ASApplication [-SiteName] <String> [[-VirtualPath] <String>] -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
Sintaxe 2
Set-ASApplication [-Uri] <Uri> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
Sintaxe 3
Set-ASApplication -ApplicationObject <ApplicationInfo> -AutoStartMode <All | Custom | Disable> [-Confirm] [-EnableApplicationPool] [-Force] [-WhatIf] [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName (obrigatório) |
Nome do site do aplicativo WCF ou WF ao qual será habilitado o início automático. |
-VirtualPath (obrigatório) |
Caminho virtual do aplicativo WCF ou WF ao qual será habilitado o início automático. |
-Uri |
Identificador de um serviço ou aplicativo específico. |
-ApplicationObject |
Nome de um objeto de aplicativo, que resulta no uso do arquivo Web.config correspondente como base de operação do cmdlet. |
–AutoStartMode <Disable> |
Um valor “Disable” especifica que o início automático será desabilitado para todos os serviços no aplicativo. |
–EnableApplicationPool (opcional) |
O nome do pool de aplicativos usado pelo aplicativo. |
Para obter as definições de início automático para um aplicativo
No console do AppFabric do Windows PowerShell, execute o cmdlet Get-ASApplication para obter as definições de início automático para um aplicativo. O cmdlet retorna as definições no objeto ApplicationInfo.
Opções de sintaxe de Get-ASApplication:
Sintaxe 1
Get-ASApplication [[-SiteName] <String>] [[-VirtualPath] <String>] [[-ApplicationPoolName] <String>] [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName (obrigatório) |
Nome do site do aplicativo WCF ou WF ao qual será obtido o início automático. |
-VirtualPath (obrigatório) |
Caminho virtual do aplicativo WCF ou WF ao qual será obtido o início automático. |
-ApplicationPoolName (obrigatório) |
O nome do pool de aplicativos usado pelo aplicativo. |
Para habilitar o início automático de um serviço
No console do AppFabric do Windows PowerShell, execute o cmdlet Enable-ASAppServiceAutoStart para habilitar o início automático de um serviço. Para fazer isso, habilite o início automático do aplicativo que contém o serviço executando Set-ASApplication com AutoStartMode definico como “Custom”. Habilitar o início automático em um serviço adiciona uma linha serviceAddress ao atributo serviceAutoStart para o serviço no arquivo Web.config do aplicativo. Você pode indicar o serviço ao qual o início automático será habilitado usando o conjunto de parâmetros –SiteName –VirtualPath, o conjunto de parâmetros –Uri ou o parâmetro ServiceObject.
Opções de sintaxe de Enable-ASAppServiceAutoStart:
Sintaxe 1
Enable-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [<CommonParameters>]
Sintaxe 2
Enable-ASAppServiceAutoStart [-Uri] <Uri> [<CommonParameters>]
Sintaxe 3
Enable-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName (obrigatório) |
Nome do site do serviço do WCF ou do WF ao qual será habilitado o início automático. |
-VirtualPath (obrigatório) |
Caminho virtual do serviço do WCF ou do WF ao qual será habilitado o início automático. |
-Uri |
Identificador de um serviço ou aplicativo específico. |
-ServiceObject |
Nome de um objeto de serviço, que resulta no uso do arquivo Web.config correspondente como a base de operação do cmdlet. |
Para desabilitar o início automático de um serviço
No console do AppFabric do Windows PowerShell, execute o cmdlet Disable-ASAppServiceAutoStart para desabilitar o início automático de um serviço. Desabilitar o início automático de um serviço remove a linha serviceAddress do atributo serviceAutoStart para o serviço no arquivo Web.config do aplicativo. Você pode indicar o serviço do qual o início automático será desabilitado usando o conjunto de parâmetros –SiteName –VirtualPath, o conjunto de parâmetros –Uri ou o parâmetro ServiceObject.
Opções de sintaxe de Disable-ASAppServiceAutoStart:
Sintaxe 1
Disable-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [-Confirm] [-WhatIf] [<CommonParameters>]
Sintaxe 2
Disable-ASAppServiceAutoStart [-Uri] <Uri> [-Confirm] [-WhatIf] [<CommonParameters>]
Sintaxe 3
Disable-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [-Confirm] [-WhatIf] [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName (obrigatório) |
Nome do site do serviço do WCF ou do WF do qual será desabilitado o início automático. |
-VirtualPath (obrigatório) |
Caminho virtual do serviço do WCF ou do WF do qual será desabilitado o início automático. |
-Uri |
Identificador de um serviço ou aplicativo específico. |
-ServiceObject |
Nome de um objeto de serviço, que resulta no uso do arquivo Web.config correspondente como a base de operação do cmdlet. |
Para obter o início automático para um serviço
No console do AppFabric do Windows PowerShell, execute o cmdlet Get-ASAppServiceAutoStart para obter as definições de início automático para um serviço. O cmdlet retorna as definições no objeto ServiceAutoStartInfo. Você pode indicar o serviço ao qual as informações de início automático serão obtidas usando o conjunto de parâmetros –SiteName –VirtualPath, o conjunto de parâmetros –Uri ou o parâmetro ServiceObject.
Opções de sintaxe de Get-ASAppServiceAutoStart:
Sintaxe 1
Get-ASAppServiceAutoStart [-SiteName] <String> [-VirtualPath] <String> [<CommonParameters>]
Sintaxe 2
Get-ASAppServiceAutoStart [-Uri] <Uri> [<CommonParameters>]
Sintaxe 3
Get-ASAppServiceAutoStart -ServiceObject <ServiceInfo> [<CommonParameters>]
| Parâmetro | Descrição |
|---|---|
-SiteName (obrigatório) |
Nome do site do serviço do WCF ou do WF ao qual obter informações de início automático. |
-VirtualPath (obrigatório) |
Caminho virtual do serviço do WCF ou do WF ao qual obter informações de início automático. |
-Uri |
Identificador de um serviço ou aplicativo específico. |
-ServiceObject |
Nome de um objeto de serviço, que resulta no uso do arquivo Web.config correspondente como a base de operação do cmdlet. |
2011-12-05