Get-AzResource

Модуль:: Az.Resources Module

Возвращает ресурсы.

Синтаксис

ByTagNameValueParameterSet (по умолчанию)

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

ByResourceId

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

ByTagObjectParameterSet

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

Описание

Командлет Get-AzResource получает ресурсы 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

Эта команда получает ресурс с указанным идентификатором ресурса, который является виртуальной машиной с именем testVM в группе ресурсов testRG.

Пример 8. Получение ресурса с расширенными свойствами

Get-AzResource -Name testVM -ResourceGroupName testRG -ExpandProperties

Эта команда получает ресурс с именем TestVM в группе ресурсов testRG и расширяет свойства, чтобы включить дополнительные сведения, такие как CreatedTime, ChangedTime и другие метаданные ресурса.

Параметры

-ApiVersion

Командлет Get-AzResource получает ресурсы Azure.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Свойства параметра

Тип:	IAzureContextContainer
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ExpandProperties

При указании разверните свойства ресурса.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

Имя извлекаемых ресурсов. Этот параметр поддерживает подстановочные знаки в начале и/или конце строки.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False
Aliases:	ИмяРесурса

Наборы параметров

ByTagNameValueParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByTagObjectParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ODataQuery

Командлет Get-AzResource получает ресурсы Azure.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Pre

Командлет Get-AzResource получает ресурсы Azure.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ResourceGroupName

Группа ресурсов, в которой извлекаются ресурсы. Этот параметр поддерживает подстановочные знаки в начале и/или конце строки.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

ByTagNameValueParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByTagObjectParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ResourceId

Указывает полный идентификатор ресурса, как показано в следующем примере. /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Идентификатор

Наборы параметров

ByResourceId

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ResourceType

Тип ресурса, который требуется извлечь. Например, Microsoft.Compute/virtualMachines

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByTagNameValueParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ByTagObjectParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Tag

Возвращает ресурсы с указанным тегом Azure. Введите хэш-таблицу с ключом "Имя" или "Имя" и "Значение". Подстановочные знаки не поддерживаются. Тег — это пара "имя-значение", которую можно применить к ресурсам и группам ресурсов. Используйте теги для классификации ресурсов, таких как отдел или центр затрат, или для отслеживания заметок или комментариев о ресурсах. Чтобы добавить тег в ресурс, используйте параметр Тега командлетов New-AzResource или Set-AzResource. Чтобы создать предопределенный тег, используйте командлет New-AzTag. Чтобы помочь с хэш-таблицами в Windows PowerShell, выполните командуGet-Help about_Hashtables.

Свойства параметра

Тип:	Hashtable
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByTagObjectParameterSet

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TagName

Ключ в теге извлекаемых ресурсов.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByTagNameValueParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TagValue

Значение в теге извлекаемых ресурсов.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ByTagNameValueParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Выходные данные

PSResource

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

Get-AzResource

Синтаксис

ByTagNameValueParameterSet (по умолчанию)

ByResourceId

ByTagObjectParameterSet

Описание

Примеры

Пример 1. Получение всех ресурсов в текущей подписке

Пример 2. Получение всех ресурсов в группе ресурсов

Пример 3. Получение всех ресурсов, группа ресурсов которых соответствует предоставленному подстановочным знаку

Пример 4. Получение всех ресурсов с заданным именем

Пример 5. Получение всех ресурсов, имя которого соответствует предоставленному подстановочным знаку

Пример 6. Получение всех ресурсов заданного типа ресурса

Пример 7. Получение ресурса по идентификатору ресурса

Пример 8. Получение ресурса с расширенными свойствами

Параметры

-ApiVersion

Свойства параметра

Наборы параметров

-DefaultProfile

Свойства параметра

Наборы параметров

-ExpandProperties

Свойства параметра

Наборы параметров

-Name

Свойства параметра

Наборы параметров

-ODataQuery

Свойства параметра

Наборы параметров

-Pre

Свойства параметра

Наборы параметров

-ResourceGroupName

Свойства параметра

Наборы параметров

-ResourceId

Свойства параметра

Наборы параметров

-ResourceType

Свойства параметра

Наборы параметров

-Tag

Свойства параметра

Наборы параметров

-TagName

Свойства параметра

Наборы параметров

-TagValue

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

String

Выходные данные

PSResource

Связанные ссылки

Обратная связь