Get-AzureWebsite
現在のサブスクリプションの Azure Web サイトを取得します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
Get-AzureWebsite
[-Name <String>]
[-Slot <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
説明
Get-AzureWebsite コマンドレットは 、 現在のサブスクリプション内の Azure Web サイトに関する情報を取得します。
既定では、 Get-AzureWebsite は現在のサブスクリプション内のすべての Azure Web サイトを取得し、サイトに関する基本情報を提供するオブジェクトを返します。 Name パラメーターを使用すると、Get-AzureWebsite は、構成の詳細など、広範な情報を含むオブジェクトを返します。
現在のサブスクリプションは、"current" として指定されているサブスクリプションです。現在のサブスクリプションを検索するには、Get-AzureSubscription コマンドレットの Current パラメーターを使用します。 現在のサブスクリプションを変更するには、Select-AzureSubscription コマンドレットを使用します。
このトピックでは、Microsoft Azure PowerShell モジュールの 0.8.10 バージョンのコマンドレットについて説明します。
使用しているモジュールのバージョンを取得するには、Azure PowerShell コンソールで「.」と入力します (Get-Module -Name Azure).Version
。
例
例 1: サブスクリプション内のすべての Web サイトを取得する
PS C:\> Get-AzureWebsite
このコマンドは、現在のサブスクリプション内のすべての Azure Web サイトを取得します。
例 2: 名前で Web サイトを取得する
PS C:\> Get-AzureWebsite -Name ContosoWeb
このコマンドは、構成情報など、ContosoWeb Azure Web サイトに関する詳細情報を取得します。 Name パラメーターを使用すると、Get-AzureWebsite は、Web サイトに関する拡張情報を含む SiteWithConfig オブジェクトを返します。
例 3: すべての Web サイトに関する詳細情報を取得する
PS C:\> Get-AzureWebsite | ForEach-Object {Get-AzureWebsite -Name $_.Name}
このコマンドは、サブスクリプション内のすべての Web サイトに関する詳細情報を取得します。 Get-AzureWebsite コマンドを使用してすべての Web サイトを取得し、ForEach-Object コマンドレットを使用して各 Web サイトを名前で取得します。
例 4: デプロイ スロットに関する情報を取得する
PS C:\> Get-AzureWebsite -Name ContosoWeb -Slot Staging
このコマンドは、ContosoWeb Web サイトのステージング デプロイ スロットを取得します。 デプロイ スロットを使用すると、一般にリリースすることなく、さまざまなバージョンの Azure Web サイトをテストできます。
例 5: Web サイト インスタンスを取得する
PS C:\>(Get-AzureWebsite -Name ContosoWeb).Instances
InstanceId
----------
2d8e712fb8f85d061c30fd793a534e6700a175f9a9ab12ca55cb3b0edfcc10ee
5834916b8cef49249b18187708223a33fbbc4352d33b48369f3166644bdd3445
PS C:\>(Get-AzureWebsite -Name ContosoWeb).Instances.Count
2
この例のコマンドでは、Azure Web サイトの Instances プロパティを使用して、現在実行中の Web サイト インスタンスに関する情報を取得します。 Instances プロパティは、Azure モジュールのバージョン 0.8.3 で SiteWithConfig オブジェクトに追加されました。
最初のコマンドは、Web サイトの現在実行中のすべてのインスタンス ID を取得します。 2 番目のコマンドは、Web サイトの実行中のインスタンスの数を取得します。 任意の配列で Count プロパティを使用できます。
パラメーター
-Name
指定した Web サイトに関する詳細な構成情報を取得します。 サブスクリプション内の 1 つの Web サイトの名前を入力します。 既定では、 Get-AzureWebsite は現在のサブスクリプション内のすべての Web サイトを取得します。 Name 値はワイルドカード文字をサポートしていません。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Slot
Web サイトの指定されたデプロイ スロットを取得します。 スロット名 ("ステージング" や "運用" など) を入力します。 デプロイ スロットの詳細については、Microsoft Azure Web サイトでの段階的なデプロイに関するページを参照してください。https://azure.microsoft.com/en-us/documentation/articles/web-sites-staged-publishing/. 既存の Azure Web サイトにデプロイ スロットを追加するには、Set-AzureWebsite コマンドレットを使用します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
入力
None
このコマンドレットへの入力はプロパティ名でパイプできますが、値によるパイプ処理は行いません。
出力
Microsoft.WindowsAzure.Commands.Utilities.Websites.Services.WebEntities.Site
既定では、Get-AzureWebsite は Site オブジェクトの配列を返します。
Microsoft.WindowsAzure.Commands.Utilities.Websites.Services.WebEntities.SiteWithConfig
Name パラメーターを使用すると、Get-AzureWebsite は SiteWithConfig オブジェクトを返します。