Escopo do cmdlet
Muitos dos cmdlets de gerenciamento do Windows Server AppFabric exigem que um escopo seja especificado para identificar onde na hierarquia do IIS (servidor, site, aplicativo ou serviço) a ação deve ser realizada.
Especificando o Escopo
Os seguintes parâmetros do Windows PowerShell podem ser usados com os cmdlets do AppFabric para especificar o escopo em que os cmdlets funcionarão:
| Parâmetro | Use |
|---|---|
-uri <sequência de caracteres> |
Um URI para um site, aplicativo, diretório virtual ou serviço do IIS, que especifica se o cmdlet operará naquele escopo. Se você usar o parâmetro Uri, não use o parâmetro SiteName ou o conjunto de parâmetros SiteName e VirtualPath. |
-SiteName <sequência de caracteres> [-VirtualPath <sequência de caracteres>] |
O parâmetro SiteName especifica o nome de um site, conforme definido no painel Conexões do IIS, que especifica que o cmdlet funcionará no escopo desse site, ou no escopo de um aplicativo, diretório virtual ou serviços contidos nesse site . Você pode adicionar o parâmetro VirtualPath ao parâmetro SiteName, que identifica um aplicativo, diretório ou serviço contido no site. Em um aplicativo ou diretório virtual, o caminho virtual inclui o nome do aplicativo, conforme definido no IIS. Em um serviço, o caminho virtual inclui o nome do aplicativo, uma barra "/" e o nome do arquivo .svc ou .xamlx para o serviço. O parâmetro VirtualPath não é necessário para o escopo do site. O caractere "/" à esquerda no caminho virtual é opcional. Se você usar o parâmetro SiteName, não use o parâmetro Uri. |
-Root |
O nome do aplicativo raiz, que especifica se o cmdlet operará naquele escopo. Se você usar o parâmetro Root, não use o parâmetro SiteName, VirtualPath ou Uri. |
-ServiceObject <ServiceInfo> |
O nome do ServiceObject, que especifica se o cmdlet operará naquele serviço. Esse parâmetro é normalmente usado para redirecionar a saída do cmdlet Get-ASAppService para um cmdlet que contém o parâmetro ServiceObject. |
-ApplicationObject <ApplicationInfo> |
O nome do ApplicationObject, que especifica se o cmdlet operará naquele aplicativo. Esse parâmetro é usado para redirecionar a saída do cmdlet Get-ASApplication para um cmdlet que contém o parâmetro ApplicationObject. |
-ServiceInstanceObject <ServiceInstanceInfo> |
O nome do ServiceInstanceObject, que especifica se o cmdlet operará naquele serviço. |
A seguir, veja algumas regras que se aplicam a escopos específicos:
Para o escopo de serviço de raiz, use o indicador de parâmetro –root.
Para o escopo de site, use o parâmetro –SiteName.
Para o escopo de aplicativo, use o conjunto de parâmetros –SiteName –VirtualPath ou o parâmetro –Uri.
Para o escopo de serviço, use o conjunto de parâmetros –SiteName –VirtualPath ou o parâmetro –Uri.
2011-12-05