Freigeben über

Get-AzureWebsite

  • Referenz
Modul:
Azure

Ruft Azure-Websites im aktuellen Abonnement ab.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Das Cmdlet Get-AzureWebsite ruft Informationen zu Azure-Websites im aktuellen Abonnement ab.

Standardmäßig ruft Get-AzureWebsite alle Azure-Websites im aktuellen Abonnement ab und gibt ein Objekt zurück, das grundlegende Informationen zu den Websites bereitstellt. Wenn Sie den Parameter Name verwenden, gibt Get-AzureWebsite ein Objekt mit umfangreichen Informationen zurück, einschließlich Konfigurationsdetails.

Das aktuelle Abonnement ist das Abonnement, das als "aktuell" festgelegt ist. Um das aktuelle Abonnement zu finden, verwenden Sie den Current-Parameter des Cmdlets "Get-AzureSubscription ". Verwenden Sie zum Ändern des aktuellen Abonnements das Cmdlet Select-AzureSubscription .

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Beispiele

Beispiel 1: Abrufen aller Websites im Abonnement

PS C:\> Get-AzureWebsite

Dieser Befehl ruft alle Azure-Websites im aktuellen Abonnement ab.

Beispiel 2: Abrufen einer Website anhand des Namens

PS C:\> Get-AzureWebsite -Name ContosoWeb

Dieser Befehl ruft detaillierte Informationen zur ContosoWeb Azure-Website ab, einschließlich Konfigurationsinformationen. Wenn Sie den Parameter Name verwenden, gibt Get-AzureWebsite ein SiteWithConfig-Objekt mit erweiterten Informationen zur Website zurück.

Beispiel 3: Abrufen detaillierter Informationen zu allen Websites

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

Dieser Befehl ruft detaillierte Informationen zu allen Websites im Abonnement ab. Es verwendet einen Befehl "Get-AzureWebsite ", um alle Websites abzurufen, und verwendet dann das Cmdlet ForEach-Object , um jede Website anhand des Namens abzurufen.

Beispiel 4: Abrufen von Informationen zu einem Bereitstellungsplatz

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

Dieser Befehl ruft den Staging-Bereitstellungsplatz der ContosoWeb-Website ab. Mit Bereitstellungsplätzen können Sie verschiedene Versionen Ihrer Azure-Website testen, ohne sie für die Öffentlichkeit freizugeben.

Beispiel 5: Abrufen von Websiteinstanzen

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

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

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

Die Befehle in diesem Beispiel verwenden die Instances-Eigenschaft einer Azure-Website, um Informationen zu derzeit ausgeführten Websiteinstanzen abzurufen. Die Instances-Eigenschaft wurde dem SiteWithConfig-Objekt in Version 0.8.3 des Azure-Moduls hinzugefügt.

Der erste Befehl ruft die Instanz-IDs aller derzeit ausgeführten Instanzen einer Website ab. Der zweite Befehl ruft die Anzahl der ausgeführten Instanzen der Website ab. Sie können die Count-Eigenschaft für ein beliebiges Array verwenden.

Parameter

-Name

Ruft detaillierte Konfigurationsinformationen zur angegebenen Website ab. Geben Sie den Namen einer Website im Abonnement ein. Standardmäßig ruft Get-AzureWebsite alle Websites im aktuellen Abonnement ab. Der Name-Wert unterstützt keine Wildcardzeichen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Slot

Ruft den angegebenen Bereitstellungsplatz der Website ab. Geben Sie den Slotnamen ein, z. B. "Staging" oder "Produktion". Weitere Informationen zu Bereitstellungsplätzen finden Sie unter Mehrstufige Bereitstellung auf Microsoft Azure-Websiteshttps://azure.microsoft.com/en-us/documentation/articles/web-sites-staged-publishing/. Verwenden Sie das Cmdlet Set-AzureWebsite, um einer vorhandenen Azure-Website einen Bereitstellungsplatz hinzuzufügen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.

Ausgaben

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

Standardmäßig gibt Get-AzureWebsite ein Array von Websiteobjekten zurück.

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

Wenn Sie den Parameter Name verwenden, gibt Get-AzureWebsite ein SiteWithConfig -Objekt zurück.