Partilhar via

Get-AzureWebsite

  • Referência
Módulo:
Azure

Obtém sites do Azure na assinatura atual.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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

Este 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}

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

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

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

Este 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 as IDs de instância de todas as instâncias atualmente em execução de um site. 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 suporta caracteres curinga.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 estágios 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 .