你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzureWebsite

获取当前订阅中的 Azure 网站。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

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

说明

Get-AzureWebsite cmdlet 获取有关当前订阅中的 Azure 网站的信息。

默认情况下, Get-AzureWebsite 获取当前订阅中的所有 Azure 网站,并返回一个对象,该对象提供有关站点的基本信息。 使用 Name 参数时, Get-AzureWebsite 返回包含大量信息的对象,包括配置详细信息。

当前订阅是指定为“current”的订阅。若要查找当前订阅,请使用 Get-AzureSubscription cmdlet 的 Current 参数。 若要更改当前订阅,请使用 Select-AzureSubscription cmdlet。

本主题介绍 Microsoft Azure PowerShell 模块的 0.8.10 版本中的 cmdlet。 若要获取正在使用的模块版本,请在 Azure PowerShell 控制台中键入 (Get-Module -Name Azure).Version

示例

示例 1:获取订阅中的所有网站

PS C:\> Get-AzureWebsite

此命令获取当前订阅中的所有 Azure 网站。

示例 2:按名称获取网站

PS C:\> Get-AzureWebsite -Name ContosoWeb

此命令获取有关 ContosoWeb Azure 网站的详细信息,包括配置信息。 使用 Name 参数时, Get-AzureWebsite 返回一个 SiteWithConfig 对象,其中包含有关网站的扩展信息。

示例 3:获取有关所有网站的详细信息

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

此命令获取有关订阅中所有网站的详细信息。 它使用 Get-AzureWebsite 命令获取所有网站,然后使用 ForEach-Object cmdlet 按名称获取每个网站。

示例 4:获取有关部署槽位的信息

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

此命令获取 ContosoWeb 网站的过渡部署槽位。 部署槽位允许测试不同版本的 Azure 网站,而无需将其发布到公众。

示例 5:获取网站实例

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

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

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

此示例中的命令使用 Azure 网站的 Instances 属性来获取有关当前正在运行的网站实例的信息。 Instances 属性已添加到 Azure 模块版本 0.8.3 中的 SiteWithConfig 对象。

第一个命令获取网站当前正在运行的所有实例的实例 ID。 第二个命令获取网站正在运行的实例数。 可以在任何数组上使用 Count 属性。

参数

-Name

获取有关指定网站的详细配置信息。 在订阅中输入一个网站的名称。 默认情况下, Get-AzureWebsite 获取当前订阅中的所有网站。 Name 值不支持通配符。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Slot

获取网站的指定部署槽位。 输入槽名称,例如“暂存”或“生产”。 有关部署槽位的详细信息,请参阅 Microsoft Azure 网站上的暂存部署https://azure.microsoft.com/en-us/documentation/articles/web-sites-staged-publishing/. 若要将部署槽添加到现有 Azure 网站,请使用 Set-AzureWebsite cmdlet。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输入

None

可以通过属性名称(而不是值)通过管道将输入传递给此 cmdlet。

输出

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

默认情况下,Get-AzureWebsite 返回 Site 对象的数组

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

使用 Name 参数时,Get-AzureWebsite 返回 SiteWithConfig 对象。