Compartir a través de

Get-AzureWebsite

  • Referencia
Módulo:
Azure

Obtiene sitios web de Azure en la suscripción actual.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Get-AzureWebsite
   [-Name <String>]
   [-Slot <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureWebsite obtiene información sobre los sitios web de Azure en la suscripción actual.

De forma predeterminada, Get-AzureWebsite obtiene todos los sitios web de Azure de la suscripción actual y devuelve un objeto que proporciona información básica sobre los sitios. Cuando se usa el parámetro Name , Get-AzureWebsite devuelve un objeto con amplia información, incluidos los detalles de configuración.

La suscripción actual es la suscripción designada como "actual". Para buscar la suscripción actual, use el parámetro Current del cmdlet Get-AzureSubscription . Para cambiar la suscripción actual, use el cmdlet Select-AzureSubscription .

En este tema se describe el cmdlet en la versión 0.8.10 del módulo de Microsoft Azure PowerShell. Para obtener la versión del módulo que usa, en la consola de Azure PowerShell, escriba (Get-Module -Name Azure).Version.

Ejemplos

Ejemplo 1: Obtener todos los sitios web de la suscripción

PS C:\> Get-AzureWebsite

Este comando obtiene todos los sitios web de Azure de la suscripción actual.

Ejemplo 2: Obtener un sitio web por nombre

PS C:\> Get-AzureWebsite -Name ContosoWeb

Este comando obtiene información detallada sobre el sitio web de Azure ContosoWeb, incluida la información de configuración. Cuando se usa el parámetro Name , Get-AzureWebsite devuelve un objeto SiteWithConfig con información extendida sobre el sitio web.

Ejemplo 3: Obtener información detallada sobre todos los sitios web

PS C:\> Get-AzureWebsite | ForEach-Object {Get-AzureWebsite -Name $_.Name}

Este comando obtiene información detallada sobre todos los sitios web de la suscripción. Usa un comando Get-AzureWebsite para obtener todos los sitios web y, a continuación, usa el cmdlet ForEach-Object para obtener cada sitio web por nombre.

Ejemplo 4: Obtener información sobre una ranura de implementación

PS C:\> Get-AzureWebsite -Name ContosoWeb -Slot Staging

Este comando obtiene la ranura de implementación de ensayo del sitio web ContosoWeb. Las ranuras de implementación le permiten probar diferentes versiones del sitio web de Azure sin publicarlas en el público.

Ejemplo 5: Obtención de instancias de sitio web

PS C:\>(Get-AzureWebsite -Name ContosoWeb).Instances

InstanceId
----------
2d8e712fb8f85d061c30fd793a534e6700a175f9a9ab12ca55cb3b0edfcc10ee
5834916b8cef49249b18187708223a33fbbc4352d33b48369f3166644bdd3445

PS C:\>(Get-AzureWebsite -Name ContosoWeb).Instances.Count
2

Los comandos de este ejemplo usan la propiedad Instances de un sitio web de Azure para obtener información sobre las instancias de sitio web que se ejecutan actualmente. La propiedad Instances se agregó al objeto SiteWithConfig en la versión 0.8.3 del módulo de Azure.

El primer comando obtiene los identificadores de instancia de todas las instancias que se ejecutan actualmente de un sitio web. El segundo comando obtiene el número de instancias en ejecución del sitio web. Puede usar la propiedad Count en cualquier matriz.

Parámetros

-Name

Obtiene información de configuración detallada sobre el sitio web especificado. Escriba el nombre de un sitio web en la suscripción. De forma predeterminada, Get-AzureWebsite obtiene todos los sitios web de la suscripción actual. El valor Name no admite caracteres comodín.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Slot

Obtiene la ranura de implementación especificada del sitio web. Escriba el nombre de ranura, como "Ensayo" o "Producción". Para obtener más información sobre las ranuras de implementación, consulte Implementación preconfigurada en sitios web de Microsoft Azure.https://azure.microsoft.com/en-us/documentation/articles/web-sites-staged-publishing/. Para agregar una ranura de implementación a un sitio web de Azure existente, use el cmdlet Set-AzureWebsite.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

None

Puede canalizar la entrada a este cmdlet por nombre de propiedad, pero no por valor.

Salidas

Microsoft.WindowsAzure.Commands.Utilities.Websites.Services.WebEntities.Site

De forma predeterminada, Get-AzureWebsite devuelve una matriz de objetos Site .

Microsoft.WindowsAzure.Commands.Utilities.Websites.Services.WebEntities.SiteWithConfig

Cuando se usa el parámetro Name , Get-AzureWebsite devuelve un objeto SiteWithConfig .