Get-AzureRmResource
Получает ресурсы.
Предупреждение
Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.
Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.
Синтаксис
Get-AzureRmResource
[[-Name] <String>]
[-ResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
[-TagName <String>]
[-TagValue <String>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzureRmResource
-ResourceId <String>
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzureRmResource
[[-Name] <String>]
[-ResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
-Tag <Hashtable>
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет Get-AzureRmResource получает ресурсы Azure.
Примеры
Пример 1. Получение всех ресурсов в текущей подписке
PS C:\> Get-AzureRmResource | ft
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. Получение всех ресурсов в группе ресурсов
PS C:\> Get-AzureRmResource -ResourceGroupName testRG | ft
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. Получение всех ресурсов, группа ресурсов которых соответствует предоставленной дикой природе карта
PS C:\> Get-AzureRmResource -ResourceGroupName other* | ft
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testKV otherRG Microsoft.KeyVault/vaults eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Эта команда получает все ресурсы, группы ресурсов которых они принадлежат в существе с "другими".
Пример 4. Получение всех ресурсов с заданным именем
PS C:\> Get-AzureRmResource -Name testVM | fl
Name : testVM
ResourceGroupName : testRG
ResourceType : Microsoft.Compute/virtualMachines
Location : westus
ResourceId : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Эта команда получает все ресурсы, имя ресурса которых — testVM.
Пример 5. Получение всех ресурсов, имя которых соответствует предоставленному диким карта
PS C:\> Get-AzureRmResource -Name test* | ft
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testVM testRG Microsoft.Compute/virtualMachines westus
testKV otherRG Microsoft.KeyVault/vaults eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Эта команда получает все ресурсы, имя ресурса которых начинается с "test".
Пример 6. Получение всех ресурсов заданного типа ресурса
PS C:\> Get-AzureRmResource -ResourceType Microsoft.Compute/virtualMachines | ft
Name ResourceGroupName ResourceType Location
---- ----------------- ------------ --------
testVM testRG Microsoft.Compute/virtualMachines westus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus
Эта команда получает все ресурсы в текущих подписках, которые являются виртуальными машинами.
Пример 7. Получение ресурса по идентификатору ресурса
PS C:\> Get-AzureRmResource -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
Эта команда получает ресурс с указанным идентификатором ресурса, который является виртуальной машиной с именем testVM в группе ресурсов testRG.
Параметры
-ApiVersion
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure
Тип: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ExpandProperties
При указании разверните свойства ресурса.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Name
Имя извлекаемых ресурсов. Этот параметр поддерживает дикие карта в начале и/или конце строки.
Тип: | String |
Aliases: | ResourceName |
Position: | 0 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ODataQuery
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Pre
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceGroupName
Группа ресурсов, в которой находится отставленный ресурс. Этот параметр поддерживает дикие карта в начале и/или конце строки.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ResourceId
Указывает полный идентификатор ресурса, как показано в следующем примере. /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines
Тип: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ResourceType
Тип ресурса, который требуется извлечь. Например, Microsoft.Compute/virtualMachines
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Tag
Возвращает ресурсы с указанным тегом Azure. Введите хэш-таблицу с ключом "Имя" или "Имя" и "Значение". Дикие карта символы не поддерживаются. Тег — это пара "имя-значение", которую можно применить к ресурсам и группам ресурсов. Используйте теги для классификации ресурсов, таких как отдел или центр затрат, или для отслеживания заметок или комментариев о ресурсах. Чтобы добавить тег в ресурс, используйте параметр Тега командлетов New-AzureRmResource или Set-AzureRmResource. Чтобы создать предопределенный тег, используйте командлет New-AzureRmTag. Чтобы получить справку по хэш-таблицам в Windows PowerShell, выполните команду Get-Help about_Hashtables.
Тип: | Hashtable |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TagName
Ключ в теге извлекаемых ресурсов.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TagValue
Значение в теге извлекаемых ресурсов.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
Microsoft.Azure.Commands.ResourceManagement.Models.PSResource