Compartilhar via

Get-AzureWebsite

  • Referência
Módulo:
Azure

Obtém sites do Azure na assinatura atual.

Observação

Os cmdlets mencionados 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, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado 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 extensas, 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 PowerShell do Microsoft Azure. 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

Este 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 testar diferentes versões do seu site do Azure sem liberá-las para o público.

Exemplo 5: Obter instâncias de 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 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 os IDs de instância de todas as instâncias de um site em execução 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 de configuração detalhadas 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 oferece 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 a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do 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 pelo nome da propriedade, mas não pelo 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 .