Get-AzureWebsite

Referência

Módulo:: Azure

Obtém sites do Azure na assinatura atual.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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 do 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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 .