Get-AzResource
구문
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>]
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
이 명령은 "other"가 있는 존재에 속한 리소스 그룹의 모든 리소스를 가져옵니다.
예제 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: 리소스 ID별 리소스 가져오기
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"이라는 가상 머신인 제공된 리소스 ID를 사용하여 리소스를 가져옵니다.
예제 8: 확장된 속성이 있는 리소스 가져오기
Get-AzResource -Name testVM -ResourceGroupName testRG -ExpandProperties
이 명령은 리소스 그룹 "testRG"에서 "testVM"이라는 리소스를 가져오고 CreatedTime, ChangedTime 및 기타 리소스 메타데이터와 같은 추가 세부 정보를 포함하도록 속성을 확장합니다.
매개 변수
-ApiVersion
Get-AzResource cmdlet은 Azure 리소스를 가져옵니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독
매개 변수 속성
형식: IAzureContextContainer
Default value: None 와일드카드 지원: False DontShow: False 별칭: AzContext, AzureRmContext, AzureCredential
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ExpandProperties
지정하면 리소스의 속성을 확장합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Name
검색할 리소스의 이름입니다. 이 매개 변수는 문자열의 시작 및/또는 끝에 와일드카드를 지원합니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: True DontShow: False 별칭: 자원명
매개 변수 집합
ByTagNameValueParameterSet
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
ByTagObjectParameterSet
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ODataQuery
Get-AzResource cmdlet은 Azure 리소스를 가져옵니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Pre
Get-AzResource cmdlet은 Azure 리소스를 가져옵니다.
매개 변수 속성
매개 변수 집합
(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
다음 예제와 같이 정규화된 리소스 ID를 지정합니다. /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False 별칭: 아이디
매개 변수 집합
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 cmdlet의 Tag 매개 변수를 사용합니다. 미리 정의된 태그를 만들려면 New-AzTag cmdlet을 사용합니다. 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
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters 를 참조하세요.
출력
