Condividi tramite

Get-AzureWebsite

  • Riferimento
Modulo:
Azure

Ottiene i siti Web di Azure nella sottoscrizione corrente.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Get-AzureWebsite ottiene informazioni sui siti Web di Azure nella sottoscrizione corrente.

Per impostazione predefinita, Get-AzureWebsite ottiene tutti i siti Web di Azure nella sottoscrizione corrente e restituisce un oggetto che fornisce informazioni di base sui siti. Quando si usa il parametro Name , Get-AzureWebsite restituisce un oggetto con informazioni complete, inclusi i dettagli di configurazione.

La sottoscrizione corrente è la sottoscrizione designata come "corrente". Per trovare la sottoscrizione corrente, usare il parametro Current del cmdlet Get-AzureSubscription . Per modificare la sottoscrizione corrente, usare il cmdlet Select-AzureSubscription .

Questo argomento descrive il cmdlet nella versione 0.8.10 del modulo Microsoft Azure PowerShell. Per ottenere la versione del modulo in uso, nella console di Azure PowerShell digitare (Get-Module -Name Azure).Version.

Esempio

Esempio 1: Ottenere tutti i siti Web nella sottoscrizione

PS C:\> Get-AzureWebsite

Questo comando ottiene tutti i siti Web di Azure nella sottoscrizione corrente.

Esempio 2: Ottenere un sito Web in base al nome

PS C:\> Get-AzureWebsite -Name ContosoWeb

Questo comando ottiene informazioni dettagliate sul sito Web ContosoWeb di Azure, incluse le informazioni di configurazione. Quando si usa il parametro Name , Get-AzureWebsite restituisce un oggetto SiteWithConfig con informazioni estese sul sito Web.

Esempio 3: Ottenere informazioni dettagliate su tutti i siti Web

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

Questo comando ottiene informazioni dettagliate su tutti i siti Web nella sottoscrizione. Usa un comando Get-AzureWebsite per ottenere tutti i siti Web e quindi usa il cmdlet ForEach-Object per ottenere ogni sito Web in base al nome.

Esempio 4: Ottenere informazioni su uno slot di distribuzione

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

Questo comando ottiene lo slot di distribuzione staging del sito Web ContosoWeb. Gli slot di distribuzione consentono di testare versioni diverse del sito Web di Azure senza rilasciarle al pubblico.

Esempio 5: Ottenere istanze del sito Web

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

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

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

I comandi in questo esempio usano la proprietà Instances di un sito Web di Azure per ottenere informazioni sulle istanze del sito Web attualmente in esecuzione. La proprietà Instances è stata aggiunta all'oggetto SiteWithConfig nella versione 0.8.3 del modulo di Azure.

Il primo comando ottiene gli ID istanza di tutte le istanze attualmente in esecuzione di un sito Web. Il secondo comando ottiene il numero di istanze in esecuzione del sito Web. È possibile usare la proprietà Count in qualsiasi matrice.

Parametri

-Name

Ottiene informazioni dettagliate sulla configurazione del sito Web specificato. Immettere il nome di un sito Web nella sottoscrizione. Per impostazione predefinita, Get-AzureWebsite ottiene tutti i siti Web nella sottoscrizione corrente. Il valore Name non supporta caratteri jolly.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Slot

Ottiene lo slot di distribuzione specificato del sito Web. Immettere il nome dello slot, ad esempio "Staging" o "Production". Per altre informazioni sugli slot di distribuzione, vedere Distribuzione a fasi nei siti Web di Microsoft Azurehttps://azure.microsoft.com/en-us/documentation/articles/web-sites-staged-publishing/. Per aggiungere uno slot di distribuzione a un sito Web di Azure esistente, usare il cmdlet Set-AzureWebsite.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

None

È possibile inviare tramite pipe l'input a questo cmdlet in base al nome della proprietà, ma non in base al valore.

Output

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

Per impostazione predefinita, Get-AzureWebsite restituisce una matrice di oggetti Site .

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

Quando si usa il parametro Name , Get-AzureWebsite restituisce un oggetto SiteWithConfig .