functions/Get-MicrosoftAzureDatacenterIPRangeFile.ps1
|
#requires -Version 3.0 function Get-MicrosoftAzureDatacenterIPRangeFile { <# .SYNOPSIS Downloads either the Microsoft Azure Datacenter IP Ranges file, or the Windows Azure Datacenter IP Ranges in China file. The file can be stored in memory or to the file system. .DESCRIPTION This CMDLet will download one of three files: Microsoft Azure Datacenter IP Ranges file (https://www.microsoft.com/en-us/download/details.aspx?id=41653) Windows Azure Datacenter IP Ranges in China (https://www.microsoft.com/en-us/download/details.aspx?id=42064) Windows Azure Datacenter IP Ranges in Germany (https://www.microsoft.com/en-us/download/details.aspx?id=54770) The region to be download is selected via the -Region parameter. It should be noted that this file is updated on a weekly basis, so if you save these file, then you should re-download them on a regular basis. This cmdlet makes use of Invoke-WebRequest. .EXAMPLE C:\PS> Get-MicrosoftAzureDatacenterIPRangeFile Returns an XML document from the Microsoft Azure Datacenter IP Ranges file .EXAMPLE C:\PS> Get-MicrosoftAzureDatacenterIPRangeFile -Path C:\Temp\AzureRanges.xml Dowloads the Microsoft Azure Datacenter IP Ranges file to C:\Temp\AzureRanges.xml .EXAMPLE C:\PS> Get-MicrosoftAzureDatacenterIPRangeFile -Region China Returns an XML document from the Microsoft Azure Datacenter IP Ranges in China file .EXAMPLE C:\PS> Get-MicrosoftAzureDatacenterIPRangeFile -Region China -Path C:\Temp\AzureRangesChina.xml Downloads the Microsoft Azure Datacenter IP Ranges in China file to C:\Temp\AzureRangesChina.xml .OUTPUTS XML document containing Azure Subnets, or Void if saving the file to the file system #> [CmdletBinding(DefaultParameterSetName = 'xml')] [OutputType([System.Xml.XmlDocument], ParameterSetName = 'path')] [OutputType([void], ParameterSetName = 'xml')] param( # Path where you want to save the XML file [Parameter(Mandatory = $false, ParameterSetName = 'path', Position = 0)] [ValidateNotNullOrEmpty()] [ValidateScript({Test-Path -Path (Split-Path -Path $_ -Parent) -PathType Container})] [String] $Path, # Specifies which region file to download, Standard, China or Germany. [Parameter(Mandatory = $false, Position = 1)] [ValidateNotNullOrEmpty()] [ValidateSet('Standard', 'China', 'Germany')] [string] $Region = 'Standard' ) switch ($Region) { 'China' { Write-Verbose -Message 'Downloading... Windows Azure Datacenter IP Ranges in China' $MicrosoftDownloadsURL = 'https://www.microsoft.com/en-us/download/confirmation.aspx?id=42064' } 'Germany' { Write-Verbose -Message 'Downloading... Windows Azure Datacenter IP Ranges in Germany' $MicrosoftDownloadsURL = 'https://www.microsoft.com/en-us/download/confirmation.aspx?id=54770' } Default { Write-Verbose -Message 'Downloading... Microsoft Azure Datacenter IP Ranges' $MicrosoftDownloadsURL = 'https://www.microsoft.com/en-us/download/confirmation.aspx?id=41653' } } $DownloadPage = Invoke-WebRequest -UseBasicParsing -Uri $MicrosoftDownloadsURL $DownloadLink = ($DownloadPage.Links | Where-Object -FilterScript {$_.outerHTML -match 'Click here' -and $_.href -match '.xml'}).href[0] if ($PSCmdlet.ParameterSetName -eq 'path') { Write-Verbose -Message ('Saving file to {0}' -f $Path) Invoke-WebRequest -UseBasicParsing -Uri $DownloadLink -OutFile $Path } else { Write-Verbose -Message 'Downloading and creating XML object' $Request = Invoke-WebRequest -UseBasicParsing -Uri $DownloadLink $RequestXML = Select-Xml -Content $Request.toString() -XPath / $RequestXML.Node } } |