functions/Get-MicrosoftAzureDatacenterIPRange.ps1
|
#requires -Version 2 function Get-MicrosoftAzureDatacenterIPRange { <# .SYNOPSIS Gets the IP ranges associated with Azure regions in CIDR format. .DESCRIPTION The Get-MicrosoftAzureDatacenterIPRange cmdlet gets a list of subnets in CIDR format (eg 192.168.1.0/24). A specific region can be specified, otherwise this cmdlet will return all subnets from all regions. The cmdlet gets the information from the Microsoft Azure Datacenter IP Ranges file, this is updated weekly, and is available for download from: https://www.microsoft.com/en-us/download/details.aspx?id=41653 or with the Get-MicrosoftAzureDatacenterIPRangeFile CMDLet. If no region is specified, then all subnets for all regions will be returned. .EXAMPLE C:\PS> Get-MicrosoftAzureDatacenterIPRange -Path C:\Temp\AzureRanges.xml -AzureRegion 'North Central US' Returns all of the subnext in the .EXAMPLE C:\PS> Get-MicrosoftAzureDatacenterIPRange -Path C:\Temp\AzureRanges.xml Explanation of what the example does .INPUTS Can take Azure region names from the pipeline. .OUTPUTS Outputs objects containing each subnet and their region. #> [CmdletBinding()] param( # Path to Microsoft Azure Datacenter IP Ranges file [Parameter(Mandatory = $true, Position = 0)] [ValidateScript({Test-Path -Path $_})] [String] $Path, # Azure Datacenter/region [Parameter(Mandatory = $false, Position = 1, ValueFromPipeline = $true)] [ValidateSet( 'West Europe', 'East US', 'East US 2', 'US West', 'North Central US', 'North Europe', 'Central US', 'East Asia', 'Southeast Asia', 'South Central US', 'Japan West', 'Japan East', 'Brazil South', 'Australia East', 'Australia Southeast', 'Central India', 'West India', 'South India' )] [String] $AzureRegion ) begin { # Read the file $PublicIPXML = [xml](Get-Content $Path) } process { # Are we selecting a specific region or returing all subnets? if ($PSBoundParameters.ContainsKey('AzureRegion')) { # Translate the friendly region name to the backend names switch ($AzureRegion) { 'West Europe' { $BackendRegionName = 'EuropeWest' } 'East US' { $BackendRegionName = 'USEast' } 'East US 2' { $BackendRegionName = 'USEast2' } 'US West' { $BackendRegionName = 'USWest' } 'North Central US' { $BackendRegionName = 'USNorth' } 'North Europe' { $BackendRegionName = 'EuropeNorth' } 'Central US' { $BackendRegionName = 'USCentral' } 'East Asia' { $BackendRegionName = 'AsiaEast' } 'Southeast Asia' { $BackendRegionName = 'AsiaSouthEast' } 'South Central US' { $BackendRegionName = 'USSouth' } 'Japan West' { $BackendRegionName = 'JapanWest' } 'Japan East' { $BackendRegionName = 'JapanEast' } 'Brazil South' { $BackendRegionName = 'BrazilSouth' } 'Australia East' { $BackendRegionName = 'AustraliaEast' } 'Australia Southeast' { $BackendRegionName = 'AustraliaSoutheast' } 'Central India' { $BackendRegionName = 'IndiaCentral' } 'West India' { $BackendRegionName = 'IndiaWest' } 'South India' { $BackendRegionName = 'IndiaSouth' } } Write-Verbose -Message "Backend region $BackendRegionName" $Subnets = ($PublicIPXML.AzurePublicIpAddresses.Region | Where-Object -FilterScript {$_.name -eq $BackendRegionName}).iprange.subnet foreach ($Subnet in $Subnets) { $OutputObject = [PSCustomObject]@{ Region = $AzureRegion Subnet = $Subnet } Write-Output -InputObject $OutputObject } } else { $Regions = $PublicIPXML.AzurePublicIpAddresses.Region foreach ($Region in $Regions) { $BackendRegionName = $Region.Name # Translate each region name to something friendly switch ($BackendRegionName) { 'EuropeWest' { $AzureRegion = 'West Europe' } 'USEast' { $AzureRegion = 'East US' } 'USEast2' { $AzureRegion = 'East US 2' } 'USWest' { $AzureRegion = 'US West' } 'USNorth' { $AzureRegion = 'North Central US' } 'EuropeNorth' { $AzureRegion = 'North Europe' } 'USCentral' { $AzureRegion = 'Central US' } 'AsiaEast' { $AzureRegion = 'East Asia' } 'AsiaSouthEast' { $AzureRegion = 'Southeast Asia' } 'USSouth' { $AzureRegion = 'South Central US' } 'JapanWest' { $AzureRegion = 'Japan West' } 'JapanEast' { $AzureRegion = 'Japan East' } 'BrazilSouth' { $AzureRegion = 'Brazil South' } 'AustraliaEast' { $AzureRegion = 'Australia East' } 'AustraliaSoutheast' { $AzureRegion = 'Australia Southeast' } 'IndiaCentral' { $AzureRegion = 'Central India' } 'IndiaWest' { $AzureRegion = 'West India' } 'IndiaSouth' { $AzureRegion = 'South India' } } Write-Verbose -Message "Azure Region Name $AzureRegion" # Create the output object foreach ($Subnet in $Region.IpRange) { $OutputObject = [PSCustomObject]@{ Region = $AzureRegion Subnet = $Subnet.Subnet } Write-Output -InputObject $OutputObject } } } } } |