Partager via

Get-AzureWebsite

  • Référence
Module:
Azure

Obtient les sites web Azure dans l’abonnement actuel.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

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

Description

L’applet de commande Get-AzureWebsite obtient des informations sur les sites web Azure dans l’abonnement actuel.

Par défaut, Get-AzureWebsite obtient tous les sites web Azure de l’abonnement actuel et retourne un objet qui fournit des informations de base sur les sites. Lorsque vous utilisez le paramètre Name , Get-AzureWebsite retourne un objet avec des informations détaillées, notamment les détails de configuration.

L’abonnement actuel est l’abonnement désigné comme « actuel ». Pour rechercher l’abonnement actuel, utilisez le paramètre Actuel de l’applet de commande Get-AzureSubscription . Pour modifier l’abonnement actuel, utilisez l’applet de commande Select-AzureSubscription .

Cette rubrique décrit l’applet de commande dans la version 0.8.10 du module Microsoft Azure PowerShell. Pour obtenir la version du module que vous utilisez, dans la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

Exemples

Exemple 1 : Obtenir tous les sites web dans l’abonnement

PS C:\> Get-AzureWebsite

Cette commande obtient tous les sites web Azure dans l’abonnement actuel.

Exemple 2 : Obtenir un site web par nom

PS C:\> Get-AzureWebsite -Name ContosoWeb

Cette commande obtient des informations détaillées sur le site web Azure ContosoWeb, y compris les informations de configuration. Lorsque vous utilisez le paramètre Name , Get-AzureWebsite retourne un objet SiteWithConfig avec des informations étendues sur le site web.

Exemple 3 : Obtenir des informations détaillées sur tous les sites web

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

Cette commande obtient des informations détaillées sur tous les sites web de l’abonnement. Il utilise une commande Get-AzureWebsite pour obtenir tous les sites web, puis utilise l’applet de commande ForEach-Object pour obtenir chaque site web par nom.

Exemple 4 : Obtenir des informations sur un emplacement de déploiement

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

Cette commande obtient l’emplacement de déploiement intermédiaire du site web ContosoWeb. Les emplacements de déploiement vous permettent de tester différentes versions de votre site web Azure sans les libérer au public.

Exemple 5 : Obtenir des instances de site web

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

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

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

Les commandes de cet exemple utilisent la propriété Instances d’un site web Azure pour obtenir des informations sur les instances de site web en cours d’exécution. La propriété Instances a été ajoutée à l’objet SiteWithConfig dans la version 0.8.3 du module Azure.

La première commande obtient les ID d’instance de toutes les instances en cours d’exécution d’un site web. La deuxième commande obtient le nombre d’instances en cours d’exécution du site web. Vous pouvez utiliser la propriété Count sur n’importe quel tableau.

Paramètres

-Name

Obtient des informations de configuration détaillées sur le site web spécifié. Entrez le nom d’un site web dans l’abonnement. Par défaut, Get-AzureWebsite obtient tous les sites web de l’abonnement actuel. La valeur Name ne prend pas en charge les caractères génériques.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Slot

Obtient l’emplacement de déploiement spécifié du site web. Entrez le nom de l’emplacement, tel que « Préproduction » ou « Production ». Pour plus d’informations sur les emplacements de déploiement, consultez Déploiement intermédiaire sur les sites web Microsoft Azurehttps://azure.microsoft.com/en-us/documentation/articles/web-sites-staged-publishing/. Pour ajouter un emplacement de déploiement à un site web Azure existant, utilisez l’applet de commande Set-AzureWebsite.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

None

Vous pouvez diriger l’entrée vers cette applet de commande par nom de propriété, mais pas par valeur.

Sorties

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

Par défaut, Get-AzureWebsite retourne un tableau d’objets site .

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

Lorsque vous utilisez le paramètre Name , Get-AzureWebsite retourne un objet SiteWithConfig .