Get-AzResource

參考

模組:: Az.Resources

取得資源。

Syntax

Get-AzResource
   [-Name <String>]
   [-ResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   [-TagName <String>]
   [-TagValue <String>]
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzResource
   -ResourceId <String>
   [-ODataQuery <String>]
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzResource
   [-Name <String>]
   [-ResourceType <String>]
   [-ODataQuery <String>]
   [-ResourceGroupName <String>]
   -Tag <Hashtable>
   [-ExpandProperties]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Get-AzResource Cmdlet 會取得 Azure 資源。

範例

範例 1：取得目前訂用帳戶中的所有資源

Get-AzResource | Format-Table

Name    ResourceGroupName  ResourceType                            Location
----    -----------------  ------------                            --------
testVM  testRG             Microsoft.Compute/virtualMachines       westus
disk    testRG             Microsoft.Compute/disks                 westus
nic     testRG             Microsoft.Network/networkInterfaces     westus
nsg     testRG             Microsoft.Network/networkSecurityGroups westus
ip      testRG             Microsoft.Network/publicIPAddresses     westus
vnet    testRG             Microsoft.Network/virtualNetworks       westus
testKV  otherRG            Microsoft.KeyVault/vaults               eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts       eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines       eastus

此命令會取得目前訂用帳戶中的所有資源。

範例 2：取得資源群組中的所有資源

Get-AzResource -ResourceGroupName testRG | Format-Table

Name   ResourceGroupName ResourceType                            Location
----   ----------------- ------------                            --------
testVM testRG            Microsoft.Compute/virtualMachines       westus
disk   testRG            Microsoft.Compute/disks                 westus
nic    testRG            Microsoft.Network/networkInterfaces     westus
nsg    testRG            Microsoft.Network/networkSecurityGroups westus
ip     testRG            Microsoft.Network/publicIPAddresses     westus
vnet   testRG            Microsoft.Network/virtualNetworks       westus

此命令會取得資源群組「testRG」中的所有資源。

範例 3：取得資源群組符合所提供通配符的所有資源

Get-AzResource -ResourceGroupName other* | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testKV  otherRG            Microsoft.KeyVault/vaults         eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

此命令會取得其資源群組所屬的資源群組與「其他」。

範例 4：取得具有指定名稱的所有資源

Get-AzResource -Name testVM | Format-List

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tags              :
                    Name    Value
                    ======  ========
                    Dept    IT
                    Year    2002
                    Status  Approved

此命令會取得資源名稱為「testVM」的所有資源。

範例 5：取得名稱符合所提供通配符的所有資源

Get-AzResource -Name test* | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testKV  otherRG            Microsoft.KeyVault/vaults         eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

此命令會取得資源名稱開頭為「test」的所有資源。

範例 6：取得指定資源類型的所有資源

Get-AzResource -ResourceType Microsoft.Compute/virtualMachines | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

此命令會取得目前訂用帳戶中的所有資源，這些資源都是虛擬機。

範例 7：依資源標識碼取得資源

Get-AzResource -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tags              :
                    Name    Value
                    ======  ========
                    Dept    IT
                    Year    2002
                    Status  Approved

此命令會取得具有所提供資源標識符的資源，這是資源群組「testRG」中名為「testVM」的虛擬機。

參數

-ApiVersion

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExpandProperties

指定時，展開資源的屬性。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

要擷取之資源的名稱。此參數支援字串開頭和/或結尾的通配符。

Type:	String
Aliases:	ResourceName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-ODataQuery

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Pre

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

擷取的資源群組屬於。此參數支援字串開頭和/或結尾的通配符。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-ResourceId

指定完整資源標識碼，如下列範例所示 /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceType

要擷取之資源的資源類型。例如，Microsoft.Compute/virtualMachines

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

取得具有指定 Azure 標籤的資源。輸入具有名稱索引鍵或 Name 和 Value 索引鍵的哈希表。不支援通配符。「標記」是可套用至資源和資源群組的名稱/值組。使用標籤來分類您的資源，例如依部門或成本中心，或追蹤有關資源的附註或批註。若要將標籤新增至資源，請使用 New-AzResource 或 Set-AzResource Cmdlet 的 Tag 參數。若要建立預先定義的標籤，請使用 New-AzTag Cmdlet。如需 Windows PowerShell 中哈希表的說明，請執行『Get-Help about_Hashtables』。

Type:	Hashtable
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TagName

要擷取之資源標籤中的索引鍵。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagValue

要擷取之資源標籤中的值。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

String

輸出

PSResource

Get-AzResource

Syntax

Description

範例

範例 1：取得目前訂用帳戶中的所有資源

範例 2：取得資源群組中的所有資源

範例 3：取得資源群組符合所提供通配符的所有資源

範例 4：取得具有指定名稱的所有資源

範例 5：取得名稱符合所提供通配符的所有資源

範例 6：取得指定資源類型的所有資源

範例 7：依資源標識碼取得資源

參數

-ApiVersion

-DefaultProfile

-ExpandProperties

-Name

-ODataQuery

-Pre

-ResourceGroupName

-ResourceId

-ResourceType

-Tag

-TagName

-TagValue

輸入

輸出

意見反應

其他資源

Get-AzResource

Syntax

Description

範例

範例 1：取得目前訂用帳戶中的所有資源

範例 2：取得資源群組中的所有資源

範例 3：取得資源群組符合所提供通配符的所有資源

範例 4：取得具有指定名稱的所有資源

範例 5：取得名稱符合所提供通配符的所有資源

範例 6：取得指定資源類型的所有資源

範例 7：依資源標識碼取得資源

參數

-ApiVersion

-DefaultProfile

-ExpandProperties

-Name

-ODataQuery

-Pre

-ResourceGroupName

-ResourceId

-ResourceType

-Tag

-TagName

-TagValue

輸入

輸出

相關連結

意見反應

其他資源