你当前正在访问 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 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
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 对象。