Compartilhar via

Get-AzureWebsite

  • Referência
Módulo:
Azure

Obtém sites do Azure na assinatura atual.

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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

Description

O cmdlet Get-AzureWebsite obtém informações sobre sites do Azure na assinatura atual.

Por padrão, Get-AzureWebsite obtém todos os sites do Azure na assinatura atual e retorna um objeto que fornece informações básicas sobre os sites. Quando você usa o parâmetro Name , Get-AzureWebsite retorna um objeto com informações abrangentes, incluindo detalhes de configuração.

A assinatura atual é a assinatura designada como "atual". Para localizar a assinatura atual, use o parâmetro Current do cmdlet Get-AzureSubscription . Para alterar a assinatura atual, use o cmdlet Select-AzureSubscription .

Este tópico descreve o cmdlet na versão 0.8.10 do módulo do Microsoft Azure PowerShell. Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

Exemplos

Exemplo 1: Obter todos os sites na assinatura

PS C:\> Get-AzureWebsite

Esse comando obtém todos os sites do Azure na assinatura atual.

Exemplo 2: Obter um site pelo nome

PS C:\> Get-AzureWebsite -Name ContosoWeb

Esse comando obtém informações detalhadas sobre o site do Azure ContosoWeb, incluindo informações de configuração. Quando você usa o parâmetro Name , Get-AzureWebsite retorna um objeto SiteWithConfig com informações estendidas sobre o site.

Exemplo 3: Obter informações detalhadas sobre todos os sites

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

Esse comando obtém informações detalhadas sobre todos os sites da assinatura. Ele usa um comando Get-AzureWebsite para obter todos os sites e, em seguida, usa o cmdlet ForEach-Object para obter cada site por nome.

Exemplo 4: Obter informações sobre um slot de implantação

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

Esse comando obtém o slot de implantação de preparo do site ContosoWeb. Os slots de implantação permitem que você teste diferentes versões do seu site do Azure sem liberá-las ao público.

Exemplo 5: Obter instâncias do site

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

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

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

Os comandos neste exemplo usam a propriedade Instances de um site do Azure para obter informações sobre as instâncias de site em execução no momento. A propriedade Instances foi adicionada ao objeto SiteWithConfig na versão 0.8.3 do módulo do Azure.

O primeiro comando obtém as IDs de instância de todas as instâncias em execução de um site no momento. O segundo comando obtém o número de instâncias em execução do site. Você pode usar a propriedade Count em qualquer matriz.

Parâmetros

-Name

Obtém informações detalhadas de configuração sobre o site especificado. Insira o nome de um site na assinatura. Por padrão, Get-AzureWebsite obtém todos os sites na assinatura atual. O valor Name não dá suporte a caracteres curinga.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Slot

Obtém o slot de implantação especificado do site. Insira o nome do slot, como "Preparação" ou "Produção". Para obter mais informações sobre slots de implantação, consulte Implantação em etapas em sites do Microsoft Azurehttps://azure.microsoft.com/en-us/documentation/articles/web-sites-staged-publishing/. Para adicionar um slot de implantação a um site existente do Azure, use o cmdlet Set-AzureWebsite.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Você pode canalizar a entrada para esse cmdlet por nome de propriedade, mas não por valor.

Saídas

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

Por padrão, Get-AzureWebsite retorna uma matriz de objetos Site .

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

Quando você usa o parâmetro Name , Get-AzureWebsite retorna um objeto SiteWithConfig .