Find-AzureRmResourceGroup

NAME Find-AzureRmResourceGroup



SYNOPSIS

Searches for resource groups.





SYNTAX

Find-AzureRmResourceGroup [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Pre] [-Tag <Hashtable>] [<CommonParameters>]





DESCRIPTION

The Find-AzureRmResourceGroup cmdlet searches for resource groups using the specified parameters.





PARAMETERS

-ApiVersion <String>

Specifies the version of the resource provider API to use. If you do not specify a version, this cmdlet uses the latest available version.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Pre [<SwitchParameter>]

Indicates that this cmdlet considers pre-release API versions when it automatically determines which version to use.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Tag <Hashtable>

Specifies tag information, as a hash table, to filter your results. Use the following formats:



@{tagName=$null} or @{tagName = 'tagValue'}.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

This cmdlet does not accept any input.





OUTPUTS

System.Management.Automation.PSObject







NOTES









Example 1: Find all resource groups



PS C:\\>Find-AzureRmResourceGroup



This command finds all resource groups.





Example 2: Find resource groups by tag name



PS C:\\>Find-AzureRmResourceGroup -Tag @{ "testtag" = $null }



This command finds all resource groups that have a tag named testtag.





Example 3: Find resource groups by tag name and value



PS C:\\>Find-AzureRmResourceGroup -Tag @{"testtag" = "testval" }



This command finds all resource groups that have a tag named testtag and the value testval.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... ourcegroup