Azure PowershellのGet-AzureRmResourceの例が間違っていないか

Question

Azure Powershell で Get-AzureRmResource コマンドを実行していて気になった事があります。

Azure PowerShellのバージョンは以下の通りです。

PS C:\Users\username> Get-Module | ft name,version

Name                            Version
----                            -------
AzureRM.Compute                 2.3.0
AzureRM.Profile                 2.3.0
AzureRM.Resources               3.3.0
Microsoft.PowerShell.Management 3.1.0.0
Microsoft.PowerShell.Utility    3.1.0.0
PackageManagement               1.0.0.1
PowerShellGet                   1.0.0.1
PSReadline                      1.2

PS C:\Users\username>

以下のコマンドを実行して、コマンドの例を見ると、こういう風に書いてあります。

get-help Get-AzureRmResource -example

    --------------------------  Example 2: Get resources by resource group  --------------------------

    PS C:\>Get-AzureRmResource -ResourceGroupName ContosoRG01

    Name              : Default1
    ResourceGroupName : ContosoLabsRG
    ResourceType      : Microsoft.Web/serverFarms
    Location          : northeurope
    ParentResource        :


    Name              : ContosoLabWeb
    ResourceGroupName : ContosoLabsRG
    ResourceType      : Microsoft.Web/sites
    Location          : northeurope
    ParentResource        :

    This commands gets all Azure resources in the ContosoRG01 resource group.

でも実際にこんな風にコマンドを打つと、エラーになります。

PS C:\Users\username>  Get-AzureRmResource -ResourceGroupName ContosoRG01
Get-AzureRmResource : 指定された名前のパラメーターを使用してパラメーター セットを解決できません。
発生場所 行:1 文字:2
+  Get-AzureRmResource -ResourceGroupName ContosoRG01
+  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Get-AzureRmResource]、ParameterBindingException
    + FullyQualifiedErrorId : AmbiguousParameterSet,Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Ge
   tAzureResourceCmdlet
PS C:\Users\username>

こちらのサイトを見ると、リソースグループ名の他にリソース名やリソースIDを指定しています。確かにそれならリソースの情報を見る事が出来ます。
https://docs.microsoft.com/en-us/powershell/module/azurerm.resources/get-azurermresource?view=azurermps-5.0.0

これは、exampleが間違えていると考えてよいのでしょうか？
だとしたら、これはどちらに報告するべきなのでしょうか？

Answer 1

こんばんは。
Azure PowerShellは詳しくないのですが既知の不具合というか仕様変更の様です。

• Get-AzureRmResource -ResourceGroupName myrgname fails

ResourceGroupNameだけを指定する場合はGet-AzureRmResourceではなくFind-AzureRmResourceを使う事が奨められています。

Find-AzureRmResource -ResourceGroupName ContosoRG01

---

ちなみに、手元のCloud Shellの環境(AzureRM.Resourcesのバージョンは5.0.0)では、

PS Azure:\> Get-Module AzureRM.Resources | select Version

Version
-------
5.0.0

PS Azure:\> get-help Get-AzureRmResource -example

NAME
    Get-AzureRmResource

SYNOPSIS
    Gets resources.


    Example 1: Get all the resources of a particular type

    PS C:\>Get-AzureRmResource -ResourceGroupName ResourceGroup11 -ResourceType microsoft.web/sites

    This command gets a resource of the type microsoft.web/sites under ResourceGroup11.


    Example 2: Get a resource by name

    PS C:\>Get-AzureRmResource -ResourceGroupName ResourceGroup11 -ResourceName ContosoWebsite

    This command gets a resource  named ContosoWebsite under ResourceGroup11.


    Example 3: Show all the status of storage accounts in a Resource Group

    PS C:\>Get-AzureRmResource -ResourceGroupName ResourceGroup11 -ResourceType Microsoft.ClassicStorage/storageAccounts -ExpandProperties
    |
       Select * -Expand Properties |
       Sort Name |
       Format-Table Name,Status*

となっておりExampleは修正されています。

Azure PowerShellはGitHubで管理されてますので、フィードバックはこちらにIssueを上げれば良いでしょう。

Comments

[usugita_san]

Get-Module AzureRM.Resources を入力しても何も出ないので、どうもインストールが必要なようです。
そこからやってみます。
ありがとうございました。