Ámbito de cmdlet
Muchos de los cmdlets de administración de Windows Server AppFabric requieren que se especifique un ámbito para identificar el lugar en la jerarquía de IIS (servidor, sitio, aplicación o servicio) debe realizarse la acción.
Especificación del ámbito
Los siguientes parámetros de Windows PowerShell pueden usarse con cmdlets de AppFabric para especificar el ámbito en el cual funcionan los cmdlets:
| Parámetro | Uso |
|---|---|
-uri <string> |
URI de un sitio, una aplicación o un directorio virtual de IIS que especifica que el cmdlet funcionará en ese ámbito. Si usa el parámetro Uri, no use el parámetro SiteName ni el conjunto de parámetros SiteName y VirtualPath. |
-SiteName <string> [-VirtualPath <string>] |
El parámetro SiteName especifica el nombre de un sitio web, tal como se define en el panel de conexiones de IIS, que especifica que el cmdlet funcionará en el ámbito de ese sitio o en el ámbito de una aplicación, un directorio virtual o un servicio incluido en ese sitio. Para el parámetro SiteName, se puede agregar el parámetro VirtualPath que identifica una aplicación, un directorio o un servicio incluido en el sitio. Para una aplicación o un directorio virtual, la ruta de acceso virtual incluye el nombre de la aplicación, tal como se define en IIS. Para un servicio, la ruta de acceso virtual incluye el nombre de la aplicación, una barra diagonal y el nombre del archivo .svc o .xamlx para el servicio. El parámetro VirtualPath no es necesario para el ámbito de sitio. El carácter "/" a la izquierda de la ruta de acceso virtual es opcional. Si usa el parámetro SiteName, no use el parámetro Uri. |
-Root |
Nombre de la aplicación raíz que especifica que el cmdlet funcionará en ese ámbito. Si usa el parámetro Root, no use los parámetros SiteName, VirtualPath o Uri. |
-ServiceObject <ServiceInfo> |
Nombre del parámetro ServiceObject que especifica que el cmdlet funcionará en ese servicio. Este parámetro normalmente se usa para canalizar la salida del cmdlet Get-ASAppService a un cmdlet que contenga el parámetro ServiceObject. |
-ApplicationObject <ApplicationInfo> |
Nombre del parámetro ApplicationObject que especifica que el cmdlet funcionará en esa aplicación. Este parámetro se usa para canalizar la salida del cmdlet Get-ASApplication a un cmdlet que contenga el parámetro ApplicationObject. |
-ServiceInstanceObject <ServiceInstanceInfo> |
Nombre del parámetro ServiceInstanceObject que especifica que el cmdlet funcionará en ese servicio. |
A continuación se indican algunas reglas aplicables a determinados ámbitos:
Para el ámbito de raíz de servicio, use el indicador de parámetro –root.
Para el ámbito de sitio, use el parámetro –SiteName.
Para el ámbito de aplicación, use el conjunto de parámetros –SiteName –VirtualPath o el parámetro –Uri.
Para el ámbito de servicio, use el conjunto de parámetros –SiteName –VirtualPath o el parámetro –Uri.
2011-12-05