Private/Office365/Invoke-GetOfficeEndpoints.ps1
|
function Invoke-GetOfficeEndpoints { [CmdletBinding()] param ( [ValidateSet('Worldwide', 'USGovDoD', 'USGovGCCHigh', 'China', 'Germany', IgnoreCase = $true)] [ValidateNotNullOrEmpty()] [string] $Instance = 'Worldwide', [ValidateSet('All', 'Common', 'Exchange', 'SharePoint', 'Skype', IgnoreCase = $true)] [ValidateNotNullOrEmpty()] [string[]] $Services = 'Exchange', [Parameter()] [switch] $Menu, [Parameter()] [switch] $IncludeURLs, [Parameter()] [switch] $Dedupe, [Parameter()] [switch] $OutputToConsole ) end { if ($Services -match 'All') { $Services = @('Exchange', 'SharePoint', 'Skype') } if (-not $Menu) { $Service = $Services -join ',' $InitialSplat = @{ Uri = 'https://endpoints.office.com/endpoints/{0}?ServiceAreas={1}&clientRequestId={2}' -f $Instance, $Service, [GUID]::NewGuid().Guid Method = 'GET' ErrorAction = 'Stop' WarningAction = 'SilentlyContinue' } $EndpointList = Invoke-RestMethod @InitialSplat foreach ($Endpoint in $EndpointList) { # IPS if ($Endpoint.ips) { $InitialList = $Endpoint.ips foreach ($Initial in $InitialList) { # TCP if ($Endpoint.tcpPorts) { foreach ($Port in $Endpoint.tcpPorts.split(',')) { [PSCustomObject]@{ id = $Endpoint.id serviceArea = $Endpoint.serviceArea tcpPorts = $Port udpPorts = '' ip = $Initial url = '' category = $Endpoint.category required = $Endpoint.required notes = $Endpoint.notes } } } # UDP if ($Endpoint.udpPorts) { foreach ($Port in $Endpoint.udpPorts.split(',')) { [PSCustomObject]@{ id = $Endpoint.id serviceArea = $Endpoint.serviceArea tcpPorts = '' udpPorts = $Port ip = $Initial url = '' category = $Endpoint.category required = $Endpoint.required notes = $Endpoint.notes } } } } } # URLS if ($Endpoint.urls -and $IncludeURLs) { $InitialList = $Endpoint.urls foreach ($Initial in $InitialList) { # TCP if ($Endpoint.tcpPorts) { foreach ($Port in $Endpoint.tcpPorts.split(',')) { [PSCustomObject]@{ id = $Endpoint.id serviceArea = $Endpoint.serviceArea tcpPorts = $Port udpPorts = '' ip = '' url = $Initial category = $Endpoint.category required = $Endpoint.required notes = $Endpoint.notes } } } # UDP if ($Endpoint.udpPorts) { foreach ($Port in $Endpoint.udpPorts.split(',')) { [PSCustomObject]@{ id = $Endpoint.id serviceArea = $Endpoint.serviceArea tcpPorts = '' udpPorts = $Port ip = '' url = $Initial category = $Endpoint.category required = $Endpoint.required notes = $Endpoint.notes } } } } } } } else { $TenantType = @('Worldwide', 'USGovDoD', 'USGovGCCHigh', 'China', 'Germany') $TenantChoice = ($TenantType | ForEach-Object { [PSCustomObject]@{ Instance = $_ } } | Out-GridView -OutputMode Single -Title "Choose tenant instance").Instance if (-not $TenantChoice) { Write-Warning "Please run again and choose a selection for each menu" return } # Get all points in time when changes have occurred with Microsoft Endpoints $VersionArray = [System.Collections.Generic.List[string]]::new() $VersionArray.Add('InitialList') $MenuRestSplat = @{ Uri = 'https://endpoints.office.com/version/{0}?AllVersions=true&clientRequestId={1}' -f $TenantChoice, [GUID]::NewGuid().Guid Method = 'GET' ErrorAction = 'Stop' WarningAction = 'SilentlyContinue' } $VersionList = Invoke-RestMethod @MenuRestSplat $VersionList.Versions | ForEach-Object { $VersionArray.Add($_) } $Script:DateChoice = $VersionArray | ForEach-Object { [PSCustomObject]@{ Choice = $_ } } | Out-GridView -OutputMode Single -Title "Choose initial list (for initial setup) or changes since a particular date" # End user selection of initial list or date of changes if (-not $DateChoice) { Write-Warning "Please run again and make a selection" return } if ($DateChoice.Choice -eq 'InitialList') { $ServicesType = @('All', 'Common', 'Exchange', 'SharePoint', 'Skype') $Services = ($ServicesType | ForEach-Object { [PSCustomObject]@{ Service = $_ } } | Out-GridView -OutputMode Multiple -Title "Choose one or more services").Service if ($Services -match 'All') { $Services = @('Exchange', 'SharePoint', 'Skype') } if (-not $Services) { Write-Warning "Please run again and choose a selection for each menu" return } Invoke-GetOfficeEndpoints -Instance $TenantChoice -Services $Services -IncludeURLs:$IncludeURLs } else { $ChangeSplat = @{ Uri = 'https://endpoints.office.com/changes/{0}/{1}?singleVersion&ClientRequestId={2}' -f $TenantChoice, $DateChoice.Choice, [GUID]::NewGuid().Guid Method = 'GET' ErrorAction = 'Stop' WarningAction = 'SilentlyContinue' } $ChangeList = Invoke-RestMethod @ChangeSplat foreach ($Change in $ChangeList) { if ($Change.Add.ips) { $ItemList = $Change.Add.ips } if ($Change.Remove.ips) { $ItemList = $Change.Remove.ips } if ($IncludeURLs) { if ($Change.Add.urls) { $ItemList = $Change.Add.urls } if ($Change.Remove.urls) { $ItemList = $Change.Remove.urls } } foreach ($Item in $ItemList) { [PSCustomObject]@{ id = $Change.id endpointsetid = $Change.endpointsetid disposition = $Change.disposition version = $Change.version impact = $Change.impact item = $Item } } } } } } } |