#load hashtable of localized string Import-LocalizedData -BindingVariable ConnectFunctions_LocalizedStrings -FileName ConnectFunctions.strings.psd1 ## Default and minimum timeout value for sessions = 3 minutes ## Maximum timeout value for sessions = 15 minutes ## $sessionOptionsTimeout = 180000; if (($env:MsExchEmsTimeout -ne $null) -and ($env:MsExchEmsTimeout -gt 180000) -and ($env:MsExchEmsTimeout -lt 900001)) { $sessionOptionsTimeout = $env:MsExchEmsTimeout; } ## # help file specific for the function Connect-ExchangeServer. # can be viewed by running: get-help Connect-ExchangeServer function Connect-ExchangeServer ($ServerFqdn, [switch]$Auto, [switch]$Prompt, $UserName, $Forest,[switch]$ClearCache, $ClientApplication=$null, [switch]$AllowClobber) { #.EXTERNALHELP Connect-ExchangeServer-help.xml set-variable VerbosePreference -value Continue :connectScope do { if (!$Auto -and ($ServerFqdn -eq $null) -and !$Prompt) { _PrintUsageAndQuit } $useWIA = $true if (!($userName -eq $null)) { $credential = get-credential $username $useWIA = $false } if (!($ServerFqdn -eq $null)) { if ($Auto -or !($Forest -eq $null)) { _PrintUsageAndQuit } _OpenExchangeRunspace $ServerFqdn $credential $useWIA -ClientApplication:$ClientApplication } if ($Auto) { # We should provide the $credential before $Forest, and we cannot assume useWIA $true here. It should be read from $useWIA _AutoDiscoverAndConnect $credential $Forest -useWIA:$useWIA -ClientApplication:$ClientApplication } else { if (!($Forest -eq $null)) { _PrintUsageAndQuit } } Write-Host $ConnectFunctions_LocalizedStrings.res_0000 $fqdn=read-host -prompt $ConnectFunctions_LocalizedStrings.res_0001 _OpenExchangeRunspace $fqdn $credential $useWIA -ClientApplication:$ClientApplication } while ($false) #connectScope if ($ClearCache) { if ($AllowClobber) { ImportPSSession -ClearCache:$true -AllowClobber } else { ImportPSSession -ClearCache:$true } } else { if ($AllowClobber) { ImportPSSession -ClearCache:$false -AllowClobber } else { ImportPSSession -ClearCache:$false } } } function Discover-ExchangeServer ([System.Management.Automation.PSCredential] $Credential, $Forest, [bool]$UseWIA=$false, [bool]$SuppressError=$false, [Microsoft.Exchange.Data.ServerVersion]$CurrentVersion=$null, $ClientApplication = "EMC", $AllowRedirection=$true) { set-variable VerbosePreference -value Continue :connectScope do { _AutoDiscoverAndConnect $Credential $Forest $UseWIA $SuppressError $CurrentVersion $ClientApplication $AllowRedirection } while ($false) #connectScope if (!($global:remoteSession -eq $null)) { $global:remoteSession.ComputerName remove-pssession $global:remoteSession } else { if ($SuppressError -and ($error.Count -ne 0)) { # When we suppress the error message, we still want the last error Write-Error $error[0] } } } function _AutoDiscoverAndConnect ([System.Management.Automation.PSCredential]$Credential, $Forest, [bool]$UseWIA=$false, [bool]$SuppressError=$false, [Microsoft.Exchange.Data.ServerVersion]$CurrentVersion=$null, $ClientApplication=$null, $AllowRedirection=$false) { if ($Forest -eq $null) { $fqdn = _GetHostFqdn $CurrentVersion if ($fqdn -ne $null) { _OpenExchangeRunspace $fqdn $credential $UseWIA $SuppressError $ClientApplication $AllowRedirection } $forestName = _GetLocalForest $siteList = _GetSites # Find servers in sites and connect, assuming the default behavior (connect to current site, # if failed then connect to adjacent sites, if failed then connect to any random site that has exchange server) foreach ($siteDN in $SiteList) { # E14: 184676 - MSIT: Tools only installation cannot find a remote PowerShell endpoint # when the Forest name of the current site is not available, then we need to pass null value for forest if (($siteDN -ne "*") -and ($forestName -ne $null)) { $servers = _GetExchangeServersInSite $siteDN "/$forestName" } else { $servers = _GetExchangeServersInSite $siteDN } if (($siteDN -ne "*")-and ($servers -eq $null)) { $siteName = $siteDN.ToString().SubString(3).Split(",")[0] Write-Warning ($ConnectFunctions_LocalizedStrings.res_0002 -f $siteName) } if (($siteDN -eq "*")-and ($servers -eq $null)) { Write-Error $ConnectFunctions_LocalizedStrings.res_0003 } _ConnectToAnyServer $servers $credential $UseWIA $SuppressError $CurrentVersion $ClientApplication $AllowRedirection } } else { $servers = _GetExchangeServersInSite "*" "/$Forest" _ConnectToAnyServer $servers $credential $UseWIA $SuppressError $CurrentVersion $ClientApplication $AllowRedirection } } function _GetSites() { $localSite=[System.DirectoryServices.ActiveDirectory.ActiveDirectorySite]::GetComputerSite() if ($localSite -eq $null) { return #no site - no auto discovery } $siteDN=$localSite.GetDirectoryEntry().DistinguishedName $siteList = New-Object System.Collections.ArrayList if ($siteDN -ne $null) { [void] $SiteList.Add($siteDN) } # DCR 231555: TAp DCR:Respect site-link costs with remote powershell. # Now go one level to find adjacent sites based on site link and add them in the site list if ($localSite.SiteLinks -ne $null) { foreach ($siteLink in $localSite.SiteLinks) { $siteDN = $null # block going backwords if (($siteLink.Sites[0] -ne $null) -and ($siteLink.Sites[0].Name -ne $localSite.Name)) { $siteDN = $siteLink.Sites[0].GetDirectoryEntry().DistinguishedName } elseif ($siteLink.Sites[1] -ne $null) { $siteDN = $siteLink.Sites[1].GetDirectoryEntry().DistinguishedName } if ($siteDN -ne $null) { [void] $SiteList.Add($siteDN) } } } # When no exchange server will be found in the current site or adjacent sites, then we should search in all sites [void] $SiteList.Add("*") $siteList } function _GetLocalForest() { [System.DirectoryServices.ActiveDirectory.Domain]::GetComputerDomain().Forest.Name } function _GetHostFqdn([Microsoft.Exchange.Data.ServerVersion]$CurrentVersion=$null) { if (@(get-item HKLM:\SOFTWARE\Microsoft\ExchangeServer\v15\*role -erroraction:silentlycontinue).length -gt 0) { $setupRegistryEntry = get-itemproperty HKLM:\SOFTWARE\Microsoft\ExchangeServer\v15\Setup -erroraction:silentlycontinue if ($CurrentVersion -ne $null -and $setupRegistryEntry -ne $null -and ($CurrentVersion.Major -ne $setupRegistryEntry.MsiProductMajor -or $CurrentVersion.Minor -ne $setupRegistryEntry.MsiProductMinor -or $CurrentVersion.Build -ne $setupRegistryEntry.MsiBuildMajor -or $CurrentVersion.Revision -ne $setupRegistryEntry.MsiBuildMinor)) { return $null } try { return [System.Net.Dns]::GetHostByName("LocalHost").HostName } catch { Write-Verbose $ConnectFunctions_LocalizedStrings.res_0004 return $null } } else { return $null } } function _GetServerFqdnFromNetworkAddress($server) { $server.properties["networkaddress"] | where {$_.ToString().StartsWith("ncacn_ip_tcp")} | %{$_.ToString().SubString(13)} } function _GetExchangeServersInSite($siteDN, $Forest=$null) { $configNC=([ADSI]"LDAP:/$Forest/RootDse").configurationNamingContext $search = new-object DirectoryServices.DirectorySearcher([ADSI]"LDAP:/$Forest/$configNC") $search.Filter = "(&(objectClass=msExchExchangeServer)(versionNumber>=1937801568)(msExchServerSite=$siteDN))" $search.PageSize=1000 $search.PropertiesToLoad.Clear() [void] $search.PropertiesToLoad.Add("msexchcurrentserverroles") [void] $search.PropertiesToLoad.Add("networkaddress") [void] $search.PropertiesToLoad.Add("serialnumber") $search.FindAll() } function _GetCurrentVersionServers($servers, [Microsoft.Exchange.Data.ServerVersion]$CurrentVersion) { $sameVersionServers=@() $sameBuildServers=@() $sameProductMajorMinorServers=@() foreach ($server in $servers) { [Microsoft.Exchange.Data.ServerVersion]$version=$null if([Microsoft.Exchange.Data.ServerVersion]::TryParseFromSerialNumber($server.Properties["serialnumber"][0], [ref]$version)) { if($version -ne $null) { if ($version.Equals($CurrentVersion)) { $sameVersionServers += $server } elseif (($version.Major -eq $CurrentVersion.Major) -and ($version.Minor -eq $CurrentVersion.Minor) -and ($version.Build -eq $CurrentVersion.Build)) { $sameBuildServers += $server } } } } return @($sameVersionServers + $sameBuildServers) } function _GetWebServiceServers($servers, [Microsoft.Exchange.Data.ServerVersion]$CurrentVersion=$null) { $allFfoWs = $servers | where {($_.properties["msexchcurrentserverroles"][0] -band 65536)} if ($allFfoWs -eq $null) { return @() } $webServiceServers = @() if ($CurrentVersion -eq $null) { $webServiceServers = $allFfoWs } else { $webServiceServers = @(_GetCurrentVersionServers $allFfoWs $CurrentVersion) } if($webServiceServers) { $serversByServiceInstance = @{} $webServiceServers | % { $fqdn = $_.properties["networkaddress"] | where {$_.ToString().StartsWith("ncalrpc")} | %{$_.ToString().SubString(8)} $location = (Get-ADComputer $fqdn -Properties "Location").Location; if(!$location) { $location = "Unknown"; } if(!$serversByServiceInstance.ContainsKey($location)) { $serversByServiceInstance.Add($location, @()); } $serversByServiceInstance[$location] += $_; } if($serversByServiceInstance.Keys.Count -gt 1) { # There are more one Service Instances so prompt user to select one $choiceList = New-Object System.Collections.ObjectModel.Collection[System.Management.Automation.Host.ChoiceDescription]; $serversByServiceInstance.Keys | % { $choiceOption = New-Object "System.Management.Automation.Host.ChoiceDescription" $_, "help"; $choiceList.Add($choiceOption); } $result = $Host.ui.PromptForChoice($ConnectFunctions_LocalizedStrings.res_0013, $ConnectFunctions_LocalizedStrings.res_0014, $choiceList, 0); $selectedServiceInstance = $choiceList[$result].Label return $serversByServiceInstance[$selectedServiceInstance]; } return $webServiceServers; } } function _GetCASServers($servers, [Microsoft.Exchange.Data.ServerVersion]$CurrentVersion=$null) { $allCas = $servers | where {($_.properties["msexchcurrentserverroles"][0] -band 4)} if ($allCas -eq $null) { return @() } if ($CurrentVersion -eq $null) { return $allCas } else { return @(_GetCurrentVersionServers $allCas $CurrentVersion) } } function _GetCAFEServers($servers, [Microsoft.Exchange.Data.ServerVersion]$CurrentVersion=$null) { $allCafes = $servers | where {($_.properties["msexchcurrentserverroles"][0] -band 1)} if ($allCafes -eq $null) { return @() } if ($CurrentVersion -eq $null) { return $allCafes } else { return @(_GetCurrentVersionServers $allCafes $CurrentVersion) } } # This function returns all non-cas and non-cafe servers, that includes mailbox, hub transport and um servers only function _GetHubMailboxUMServers($servers, [Microsoft.Exchange.Data.ServerVersion]$CurrentVersion=$null) { $allNonCasCafe = $servers | where {(($_.properties["msexchcurrentserverroles"][0] -band 4) -eq 0) -and (($_.properties["msexchcurrentserverroles"][0] -band 1) -eq 0) -and ($_.properties["msexchcurrentserverroles"][0] -band 50)} if ($allNonCasCafe -eq $null) { return @() } if ($CurrentVersion -eq $null) { return $allNonCasCafe } else { return @(_GetCurrentVersionServers $allNonCasCafe $CurrentVersion) } } function _NewExchangeRunspace( [String]$fqdn, [System.Management.Automation.PSCredential] $credential=$null, [bool]$UseWIA=$true, [bool]$SuppressError=$false, $ClientApplication=$null, $AllowRedirection=$false, [String]$targetServerUriParameter=$null) { $hostFQDN = _GetHostFqdn if (($fqdn -ne $null) -and ($hostFQDN -ne $null) -and ($hostFQDN.ToLower() -eq $fqdn.ToLower())) { $ServicesRunning = _CheckServicesStarted if ($ServicesRunning -eq $false) { return } } Write-Verbose ($ConnectFunctions_LocalizedStrings.res_0005 -f $fqdn) $so = New-PSSessionOption -OperationTimeout $sessionOptionsTimeout -IdleTimeout $sessionOptionsTimeout -OpenTimeout $sessionOptionsTimeout; $setupRegistryEntry = get-itemproperty HKLM:\SOFTWARE\Microsoft\ExchangeServer\v15\Setup -erroraction:silentlycontinue if ( $setupRegistryEntry -ne $null) { $clientVersion = "{0}.{1}.{2}.{3}" -f $setupRegistryEntry.MsiProductMajor, $setupRegistryEntry.MsiProductMinor, $setupRegistryEntry.MsiBuildMajor, $setupRegistryEntry.MsiBuildMinor $connectionUri = "http://$fqdn/powershell?serializationLevel=Full;ExchClientVer=$clientVersion" } else { $connectionUri = "http://$fqdn/powershell?serializationLevel=Full" } if ($ClientApplication -ne $null) { $connectionUri = $connectionUri + ";clientApplication=$ClientApplication" } if ($targetServerUriParameter -ne $null) { $connectionUri = $connectionUri + ";TargetServer=$targetServerUriParameter" } $contents = 'New-PSSession -ConnectionURI "$connectionUri" -ConfigurationName Microsoft.Exchange -SessionOption $so' if (-not $UseWIA) { $contents = $contents + ' -Authentication Kerberos -Credential $credential' } if ($SuppressError) { $contents = $contents + ' -erroraction silentlycontinue' } if ($AllowRedirection) { $contents = $contents + ' -AllowRedirection' } [ScriptBlock] $command = $executioncontext.InvokeCommand.NewScriptBlock([string]::join("`n", $contents)) $session=invoke-command -Scriptblock $command if (!$?) { # ERROR_ACCESS_DENIED = 5 # ERROR_LOGON_FAILURE = 1326 if (!(5 -eq $error[0].exception.errorcode) -and !(1326 -eq $error[0].exception.errorcode)) { #Write-Verbose ($ConnectFunctions_LocalizedStrings.res_0006 -f $fqdn) return } else { # no retries if we get 5 (access denied) or 1326 (logon failure) #$REVIEW$ connectedFqdn is not set. Is it okay? break connectScope } } $session } function _OpenExchangeRunspace([String]$fqdn, [System.Management.Automation.PSCredential] $credential, [bool]$UseWIA=$true, [bool]$SuppressError=$false, $ClientApplication=$null, $AllowRedirection=$false) { $global:remoteSession = _NewExchangeRunspace $fqdn $credential $UseWIA $SuppressError $ClientApplication $AllowRedirection if ($global:remoteSession -ne $null) { $global:connectedFqdn = $fqdn break connectScope } } function CreateOrGetExchangeSession( [String]$fqdn, [System.Management.Automation.PSCredential] $credential=$null, [bool]$UseWIA=$true, [bool]$SuppressError=$false, [String]$targetServerUriParameter=$null) { $existingSession = @(Get-PSSession | Where {$_.ComputerName -eq $fqdn -and $_.Availability -eq 'Available' -and $_.ConfigurationName -eq 'Microsoft.Exchange'}) if (($existingSession.Count -gt 0) -and ($targetServerUriParameter -eq $null)) { if ($existingSession.Count -gt 1) { Write-Warning ($ConnectFunctions_LocalizedStrings.res_0007 -f $fqdn) } Write-Verbose ($ConnectFunctions_LocalizedStrings.res_0008 -f $fqdn) return $existingSession[0] } else { Write-Verbose ($ConnectFunctions_LocalizedStrings.res_0009 -f $fqdn) _NewExchangeRunspace $fqdn $credential $UseWIA $SuppressError $null $false $targetServerUriParameter } } function _ConnectToAnyServer ($servers, $credential, [bool]$UseWIA=$false, [bool]$SuppressError=$false, [Microsoft.Exchange.Data.ServerVersion]$CurrentVersion=$null, $ClientApplication=$null, $AllowRedirection=$false) { if (($servers -eq $null) -or ($servers.Length -eq 0)) { return } $cafe=@(_GetCAFEServers $servers $CurrentVersion) for($i=0;$i -lt $cafe.Length;$i++) { $fqdn = _GetServerFqdnFromNetworkAddress $cafe[($i+$start) % $cafe.Length] _OpenExchangeRunspace $fqdn $credential $UseWIA $SuppressError $ClientApplication $AllowRedirection } $webServiceServers=@(_GetWebServiceServers $servers $CurrentVersion) for($i=0;$i -lt $webServiceServers.Length;$i++) { $fqdn = _GetServerFqdnFromNetworkAddress $webServiceServers[($i+$start) % $webServiceServers.Length] _OpenExchangeRunspace $fqdn $credential $UseWIA $SuppressError $ClientApplication $AllowRedirection } $cas=@(_GetCASServers $servers) for($i=0;$i -lt $cas.Length;$i++) { $fqdn = _GetServerFqdnFromNetworkAddress $cas[($i+$start) % $cas.Length] _OpenExchangeRunspace $fqdn $credential $UseWIA $SuppressError $ClientApplication $AllowRedirection } $other=@(_GetHubMailboxUMServers $servers $CurrentVersion) for($i=0;$i -lt $other.Length;$i++) { $fqdn = _GetServerFqdnFromNetworkAddress $other[($i+$start) % $other.Length] _OpenExchangeRunspace $fqdn $credential $UseWIA $SuppressError $ClientApplication $AllowRedirection } } function _PrintUsageAndQuit { $ConnectFunctions_LocalizedStrings.res_0012 break connectScope } function _CheckServicesStarted { #List of services that should be running while connecting to remote server $DependentServices = @('w3svc') foreach ($Service in $DependentServices) { $ServiceState = Get-Service $Service -ea SilentlyContinue $ServiceNameFull = $ServiceState.Name + ' (' + $ServiceState.DisplayName + ')' if ($ServiceState.Status -ne 'Running') { Write-Warning ($ConnectFunctions_LocalizedStrings.res_0010 -f $ServiceNameFull) return $false } } return $true } # This function is used to discover ECP when EMC connects to localOnPremise function Discover-EcpVirtualDirectoryForEmc ([Microsoft.Exchange.Data.ServerVersion]$CurrentVersion, [bool]$UseWIA=$false, $TargetServerFqdn=$null) { # get the siteDN, forest $forestName = _GetLocalForest $siteList = _GetSites # Get the localhost's fqdn so we can check the vdir on local machine first $hostFqdn = _GetHostFqdn # declare $version to store the return value from TryParseFromSerialNumber [Microsoft.Exchange.Data.ServerVersion]$version=$null # declare the DirectorySearcher of ECP vdir for later use $search = new-object DirectoryServices.DirectorySearcher $search.Filter = "(&(objectClass=msExchEcpVirtualDirectory))" $search.PageSize=1000 $search.PropertiesToLoad.Clear() [void] $search.PropertiesToLoad.Add("msexchinternalauthenticationmethods") [void] $search.PropertiesToLoad.Add("msexchinternalhostname") [void] $search.PropertiesToLoad.Add("msexchexternalhostname") # When EMC is connected as RemoteOnPremise, it's possible that the server is in the same forest as the host machine # so we check for that before we do autodiscover. This variable is used to do that $shouldDiscover=$false # first look at local site, then expand scope to forest foreach ($siteDN in $SiteList) { # Init variables if (($siteDN -ne "*") -and ($forestName -ne $null)) { $allServers = _GetExchangeServersInSite $siteDN "/$forestName" } else { $allServers = _GetExchangeServersInSite $siteDN } if($allServers -ne $null) { # if $shouldDiscover is false, we should check whether we should do discovery or not first if($shouldDiscover -eq $false){ if($TargetServerFqdn -ne $null) { # TargetServerFqdn is specified, which means we are connecting using remoteOnPremise # so we need to check whether the targetServer is in the same forest or not. foreach ($server in $allServers) { $tempFqdn = _GetServerFqdnFromNetworkAddress $server if (($TargetServerFqdn -eq $tempFqdn)) { $shouldDiscover=$true break } } }else{ $shouldDiscover=$true } if($shouldDiscover -eq $false){ continue } } $servers = _GetCASServers $allServers #continue if there's no CAS if(($servers -eq $null) -or ($servers.length -eq 0)){ continue } # group the servers by version $localServer=$null $sameVersionServers=@() $newerVersionServers=@() $olderServers=@() foreach ($server in $servers) { # if the version can't be parsed, we will skip this server if([Microsoft.Exchange.Data.ServerVersion]::TryParseFromSerialNumber($server.Properties["serialnumber"][0], [ref]$version)) { # only look for server with same major version if($version.Major -eq $CurrentVersion.Major) { if($version.Equals($CurrentVersion)) { $fqdn = _GetServerFqdnFromNetworkAddress $server if (($hostFQDN -ne $null) -and ($hostFQDN -eq $fqdn)){ # if it's localhost, insert it into the front of the array so it's checked before others $sameVersionServers = @($server)+$sameVersionServers }else{ $sameVersionServers += $server } }elseif($version.ToInt() -gt $CurrentVersion.ToInt()){ $newerVersionServers += $server }else{ $olderServers += $server } } } } # find a suitable vdir, the order here shouldn't be changed foreach ($servers in @($sameVersionServers,$newerVersionServers,$olderServers)) { $fbaVdirs=@() $allVdirs=@() foreach($server in $servers) { Write-Verbose ($ConnectFunctions_LocalizedStrings.res_0011 -f $server) $search.SearchRoot=[ADSI]$server.Path $vdirs=$search.FindAll(); $tempFba=$null if($vdirs -ne $null) { $selected,$tempFba= _SelectVdir $vdirs $useWIA if( $selected -ne $null ) { return _GetUrl $selected }else{ $fbaVdirs+=$tempFba $allVdirs+=$vdirs } } } if($fbaVdirs.length -gt 0) { # we can't find a WIA vdir, so just return a fbaVdir return _GetUrl $fbaVdirs[0] } elseif($allVdirs.length -gt 0) { # we can't even find a FBA vdir, so just return any vdir return _GetUrl $vdirs[0] } } } } } # select vdir based on the criteria # Parameters # vdirs: a list of vdirs to be selected from # useWIA: True->select a WIA; False->select a FBA # Return: # retVal: vdir that matches the authentication mode requested # fbaVdirs: return the list of fbaVdirs for caller function _SelectVdir ($vdirs, [bool]$useWIA) { $fbaVdirs=@() $retVal=$null # randomize the start position. There are two benefits # 1. If the first server is down, this randomization will allow us to pick other servers # 2. It helps load ballancing. $random = New-Object System.Random $start = $random.Next(0, $vdirs.Count) for($i=$start; ($i-$start) -lt $vdirs.Count; $i++) { $vdir = $vdirs[$i % $vdirs.Count] # search for WIA vdir if($useWIA) { if(_IsWIA $vdir) { $retVal=$vdir break } } # see if it's FBA if(_IsFBA $vdir) { if($useWIA) { # save the vdirs in case we can't find a WIA vdir later $fbaVdirs += $vdir } else { # we are looking for FBA here, so just return $retVal = $vdir break } } } return $retVal, $fbaVdirs } # determine if authentication mode is WIA. According to AuthenticationMethodFlags, Ntlm is 2, WindowsIntegrated is 16. # Exchange's task will normally set them both. But actually normally windows supports both, so I'll return true if either # of them is set.Also note that we are checking the internal autentication flag. function _IsWIA ($vdir) { _InternalAuthenticationMatchesAny $vdir 18 } # determine if authentication mode is FBA. According to AuthenticationMethodFlags, Fba is 4. # Note that Exchange's task will set Basic to true when FBA is true. # Note that I'm not checking external authentication flags. Task Set-EcpVdir -FormAuthentication:$false, it's only # updating the internal flag, function _IsFBA ($vdir) { _InternalAuthenticationMatchesAny $vdir 4 } # select vdir based on the criteria # Parameters # vdir: vdir to check # flag: target flag # Return: # true if vdir's msexchinternalauthenticationmethods has any of the $flag function _InternalAuthenticationMatchesAny($vdir, $flag) { if($vdir.Properties["msexchinternalauthenticationmethods"] -ne $null) { ($vdir.Properties["msexchinternalauthenticationmethods"][0] -band $flag) -ne 0 } else { return $false } } # get the url from a vdir function _GetUrl ($vdir) { if($vdir.Properties["msexchinternalhostname"] -ne $null) { $vdir.Properties["msexchinternalhostname"] }elseif($vdir.Properties["msexchexternalhostname"] -ne $null) { $vdir.Properties["msexchexternalhostname"] } } # SIG # Begin signature block # MIIauQYJKoZIhvcNAQcCoIIaqjCCGqYCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUlum74b4Vkf6q5Q339ufxJZFI # MNegghV6MIIEuzCCA6OgAwIBAgITMwAAAFnWc81RjvAixQAAAAAAWTANBgkqhkiG # 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw # HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTQwNTIzMTcxMzE1 # WhcNMTUwODIzMTcxMzE1WjCBqzELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # DTALBgNVBAsTBE1PUFIxJzAlBgNVBAsTHm5DaXBoZXIgRFNFIEVTTjpGNTI4LTM3 # NzctOEE3NjElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC # ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMZsTs9oU/3vgN7oi8Sx8H4H # zh487AyMNYdM6VE6vLawlndC+v88z+Ha4on6bkIAmVsW3QlkOOJS+9+O+pOjPbuH # j264h8nQYE/PnIKRbZEbchCz2EN8WUpgXcawVdAn2/L2vfIgxiIsnmuLLWzqeATJ # S8FwCee2Ha+ajAY/eHD6du7SJBR2sq4gKIMcqfBIkj+ihfeDysVR0JUgA3nSV7wT # tU64tGxWH1MeFbvPMD/9OwHNX3Jo98rzmWYzqF0ijx1uytpl0iscJKyffKkQioXi # bS5cSv1JuXtAsVPG30e5syNOIkcc08G5SXZCcs6Qhg4k9cI8uQk2P6hTXFb+X2EC # AwEAAaOCAQkwggEFMB0GA1UdDgQWBBRbKBqzzXUNYz39mfWbFQJIGsumrDAfBgNV # HSMEGDAWgBQjNPjZUkZwCu1A+3b7syuwwzWzDzBUBgNVHR8ETTBLMEmgR6BFhkNo # dHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNyb3Nv # ZnRUaW1lU3RhbXBQQ0EuY3JsMFgGCCsGAQUFBwEBBEwwSjBIBggrBgEFBQcwAoY8 # aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNyb3NvZnRUaW1l # U3RhbXBQQ0EuY3J0MBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEBBQUA # A4IBAQB68A30RWw0lg538OLAQgVh94jTev2I1af193/yCPbV/cvKdHzbCanf1hUH # mb/QPoeEYnvCBo7Ki2jiPd+eWsWMsqlc/lliJvXX+Xi2brQKkGVm6VEI8XzJo7cE # N0bF54I+KFzvT3Gk57ElWuVDVDMIf6SwVS3RgnBIESANJoEO7wYldKuFw8OM4hRf # 6AVUj7qGiaqWrpRiJfmvaYgKDLFRxAnvuIB8U5B5u+mP0EjwYsiZ8WU0O/fOtftm # mLmiWZldPpWfFL81tPuYciQpDPO6BHqCOftGzfHgsha8fSD4nDkVJaEmLdaLgb3G # vbCdVP5HC18tTir0h+q1D7W37ZIpMIIE7DCCA9SgAwIBAgITMwAAAMps1TISNcTh # VQABAAAAyjANBgkqhkiG9w0BAQUFADB5MQswCQYDVQQGEwJVUzETMBEGA1UECBMK # V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0 # IENvcnBvcmF0aW9uMSMwIQYDVQQDExpNaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBD # QTAeFw0xNDA0MjIxNzM5MDBaFw0xNTA3MjIxNzM5MDBaMIGDMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMQ0wCwYDVQQLEwRNT1BSMR4wHAYDVQQD # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw # ggEKAoIBAQCWcV3tBkb6hMudW7dGx7DhtBE5A62xFXNgnOuntm4aPD//ZeM08aal # IV5WmWxY5JKhClzC09xSLwxlmiBhQFMxnGyPIX26+f4TUFJglTpbuVildGFBqZTg # rSZOTKGXcEknXnxnyk8ecYRGvB1LtuIPxcYnyQfmegqlFwAZTHBFOC2BtFCqxWfR # +nm8xcyhcpv0JTSY+FTfEjk4Ei+ka6Wafsdi0dzP7T00+LnfNTC67HkyqeGprFVN # TH9MVsMTC3bxB/nMR6z7iNVSpR4o+j0tz8+EmIZxZRHPhckJRIbhb+ex/KxARKWp # iyM/gkmd1ZZZUBNZGHP/QwytK9R/MEBnAgMBAAGjggFgMIIBXDATBgNVHSUEDDAK # BggrBgEFBQcDAzAdBgNVHQ4EFgQUH17iXVCNVoa+SjzPBOinh7XLv4MwUQYDVR0R # BEowSKRGMEQxDTALBgNVBAsTBE1PUFIxMzAxBgNVBAUTKjMxNTk1K2I0MjE4ZjEz # LTZmY2EtNDkwZi05YzQ3LTNmYzU1N2RmYzQ0MDAfBgNVHSMEGDAWgBTLEejK0rQW # WAHJNy4zFha5TJoKHzBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jv # c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNDb2RTaWdQQ0FfMDgtMzEtMjAx # MC5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1p # Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY0NvZFNpZ1BDQV8wOC0zMS0yMDEwLmNy # dDANBgkqhkiG9w0BAQUFAAOCAQEAd1zr15E9zb17g9mFqbBDnXN8F8kP7Tbbx7Us # G177VAU6g3FAgQmit3EmXtZ9tmw7yapfXQMYKh0nfgfpxWUftc8Nt1THKDhaiOd7 # wRm2VjK64szLk9uvbg9dRPXUsO8b1U7Brw7vIJvy4f4nXejF/2H2GdIoCiKd381w # gp4YctgjzHosQ+7/6sDg5h2qnpczAFJvB7jTiGzepAY1p8JThmURdwmPNVm52Iao # AP74MX0s9IwFncDB1XdybOlNWSaD8cKyiFeTNQB8UCu8Wfz+HCk4gtPeUpdFKRhO # lludul8bo/EnUOoHlehtNA04V9w3KDWVOjic1O1qhV0OIhFeezCCBbwwggOkoAMC # AQICCmEzJhoAAAAAADEwDQYJKoZIhvcNAQEFBQAwXzETMBEGCgmSJomT8ixkARkW # A2NvbTEZMBcGCgmSJomT8ixkARkWCW1pY3Jvc29mdDEtMCsGA1UEAxMkTWljcm9z # b2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MB4XDTEwMDgzMTIyMTkzMloX # DTIwMDgzMTIyMjkzMloweTELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0 # b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh # dGlvbjEjMCEGA1UEAxMaTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EwggEiMA0G # CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCycllcGTBkvx2aYCAgQpl2U2w+G9Zv # zMvx6mv+lxYQ4N86dIMaty+gMuz/3sJCTiPVcgDbNVcKicquIEn08GisTUuNpb15 # S3GbRwfa/SXfnXWIz6pzRH/XgdvzvfI2pMlcRdyvrT3gKGiXGqelcnNW8ReU5P01 # lHKg1nZfHndFg4U4FtBzWwW6Z1KNpbJpL9oZC/6SdCnidi9U3RQwWfjSjWL9y8lf # RjFQuScT5EAwz3IpECgixzdOPaAyPZDNoTgGhVxOVoIoKgUyt0vXT2Pn0i1i8UU9 # 56wIAPZGoZ7RW4wmU+h6qkryRs83PDietHdcpReejcsRj1Y8wawJXwPTAgMBAAGj # ggFeMIIBWjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTLEejK0rQWWAHJNy4z # Fha5TJoKHzALBgNVHQ8EBAMCAYYwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEE # AYI3FQIEFgQU/dExTtMmipXhmGA7qDFvpjy82C0wGQYJKwYBBAGCNxQCBAweCgBT # AHUAYgBDAEEwHwYDVR0jBBgwFoAUDqyCYEBWJ5flJRP8KuEKU5VZ5KQwUAYDVR0f # BEkwRzBFoEOgQYY/aHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJv # ZHVjdHMvbWljcm9zb2Z0cm9vdGNlcnQuY3JsMFQGCCsGAQUFBwEBBEgwRjBEBggr # BgEFBQcwAoY4aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNy # b3NvZnRSb290Q2VydC5jcnQwDQYJKoZIhvcNAQEFBQADggIBAFk5Pn8mRq/rb0Cx # MrVq6w4vbqhJ9+tfde1MOy3XQ60L/svpLTGjI8x8UJiAIV2sPS9MuqKoVpzjcLu4 # tPh5tUly9z7qQX/K4QwXaculnCAt+gtQxFbNLeNK0rxw56gNogOlVuC4iktX8pVC # nPHz7+7jhh80PLhWmvBTI4UqpIIck+KUBx3y4k74jKHK6BOlkU7IG9KPcpUqcW2b # Gvgc8FPWZ8wi/1wdzaKMvSeyeWNWRKJRzfnpo1hW3ZsCRUQvX/TartSCMm78pJUT # 5Otp56miLL7IKxAOZY6Z2/Wi+hImCWU4lPF6H0q70eFW6NB4lhhcyTUWX92THUmO # Lb6tNEQc7hAVGgBd3TVbIc6YxwnuhQ6MT20OE049fClInHLR82zKwexwo1eSV32U # jaAbSANa98+jZwp0pTbtLS8XyOZyNxL0b7E8Z4L5UrKNMxZlHg6K3RDeZPRvzkbU # 0xfpecQEtNP7LN8fip6sCvsTJ0Ct5PnhqX9GuwdgR2VgQE6wQuxO7bN2edgKNAlt # HIAxH+IOVN3lofvlRxCtZJj/UBYufL8FIXrilUEnacOTj5XJjdibIa4NXJzwoq6G # aIMMai27dmsAHZat8hZ79haDJLmIz2qoRzEvmtzjcT3XAH5iR9HOiMm4GPoOco3B # oz2vAkBq/2mbluIQqBC0N1AI1sM9MIIGBzCCA++gAwIBAgIKYRZoNAAAAAAAHDAN # BgkqhkiG9w0BAQUFADBfMRMwEQYKCZImiZPyLGQBGRYDY29tMRkwFwYKCZImiZPy # LGQBGRYJbWljcm9zb2Z0MS0wKwYDVQQDEyRNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp # Y2F0ZSBBdXRob3JpdHkwHhcNMDcwNDAzMTI1MzA5WhcNMjEwNDAzMTMwMzA5WjB3 # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYDVQQDExhN # aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw # ggEKAoIBAQCfoWyx39tIkip8ay4Z4b3i48WZUSNQrc7dGE4kD+7Rp9FMrXQwIBHr # B9VUlRVJlBtCkq6YXDAm2gBr6Hu97IkHD/cOBJjwicwfyzMkh53y9GccLPx754gd # 6udOo6HBI1PKjfpFzwnQXq/QsEIEovmmbJNn1yjcRlOwhtDlKEYuJ6yGT1VSDOQD # LPtqkJAwbofzWTCd+n7Wl7PoIZd++NIT8wi3U21StEWQn0gASkdmEScpZqiX5NMG # gUqi+YSnEUcUCYKfhO1VeP4Bmh1QCIUAEDBG7bfeI0a7xC1Un68eeEExd8yb3zuD # k6FhArUdDbH895uyAc4iS1T/+QXDwiALAgMBAAGjggGrMIIBpzAPBgNVHRMBAf8E # BTADAQH/MB0GA1UdDgQWBBQjNPjZUkZwCu1A+3b7syuwwzWzDzALBgNVHQ8EBAMC # AYYwEAYJKwYBBAGCNxUBBAMCAQAwgZgGA1UdIwSBkDCBjYAUDqyCYEBWJ5flJRP8 # KuEKU5VZ5KShY6RhMF8xEzARBgoJkiaJk/IsZAEZFgNjb20xGTAXBgoJkiaJk/Is # ZAEZFgltaWNyb3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBSb290IENlcnRpZmlj # YXRlIEF1dGhvcml0eYIQea0WoUqgpa1Mc1j0BxMuZTBQBgNVHR8ESTBHMEWgQ6BB # hj9odHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9taWNy # b3NvZnRyb290Y2VydC5jcmwwVAYIKwYBBQUHAQEESDBGMEQGCCsGAQUFBzAChjho # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY3Jvc29mdFJvb3RD # ZXJ0LmNydDATBgNVHSUEDDAKBggrBgEFBQcDCDANBgkqhkiG9w0BAQUFAAOCAgEA # EJeKw1wDRDbd6bStd9vOeVFNAbEudHFbbQwTq86+e4+4LtQSooxtYrhXAstOIBNQ # md16QOJXu69YmhzhHQGGrLt48ovQ7DsB7uK+jwoFyI1I4vBTFd1Pq5Lk541q1YDB # 5pTyBi+FA+mRKiQicPv2/OR4mS4N9wficLwYTp2OawpylbihOZxnLcVRDupiXD8W # mIsgP+IHGjL5zDFKdjE9K3ILyOpwPf+FChPfwgphjvDXuBfrTot/xTUrXqO/67x9 # C0J71FNyIe4wyrt4ZVxbARcKFA7S2hSY9Ty5ZlizLS/n+YWGzFFW6J1wlGysOUzU # 9nm/qhh6YinvopspNAZ3GmLJPR5tH4LwC8csu89Ds+X57H2146SodDW4TsVxIxIm # dgs8UoxxWkZDFLyzs7BNZ8ifQv+AeSGAnhUwZuhCEl4ayJ4iIdBD6Svpu/RIzCzU # 2DKATCYqSCRfWupW76bemZ3KOm+9gSd0BhHudiG/m4LBJ1S2sWo9iaF2YbRuoROm # v6pH8BJv/YoybLL+31HIjCPJZr2dHYcSZAI9La9Zj7jkIeW1sMpjtHhUBdRBLlCs # lLCleKuzoJZ1GtmShxN1Ii8yqAhuoFuMJb+g74TKIdbrHk/Jmu5J4PcBZW+JC33I # acjmbuqnl84xKf8OxVtc2E0bodj6L54/LlUWa8kTo/0xggSpMIIEpQIBATCBkDB5 # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSMwIQYDVQQDExpN # aWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQQITMwAAAMps1TISNcThVQABAAAAyjAJ # BgUrDgMCGgUAoIHCMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQB # gjcCAQsxDjAMBgorBgEEAYI3AgEVMCMGCSqGSIb3DQEJBDEWBBTNTAcVgTYRMXPa # wGVlVotgcgyWvTBiBgorBgEEAYI3AgEMMVQwUqAqgCgAQwBvAG4AbgBlAGMAdABG # AHUAbgBjAHQAaQBvAG4AcwAuAHAAcwAxoSSAImh0dHA6Ly93d3cubWljcm9zb2Z0 # LmNvbS9leGNoYW5nZSAwDQYJKoZIhvcNAQEBBQAEggEAIfuDRWtOrpQvxSgfeqb7 # c5ZgrhWST8TGSHsGjFoU6ZS09sJ1a06YkFEZzox5wS7FrvD/K0YwPoVlAb0e3zI9 # YqCI1lj7uVOW0/M4dVoN7K1TCotRjpaWYEl9+CD0upiv016XyFEf1buCazj5fvNw # cFQpkAsUZCVZVf5Y41PM4JoSfv4AxZYMvkqhGYm4GFmG9Duy2c0ljI0s6MoumVDH # PoSxNUhkXFRGAi1genfhnjTv1JxUZWjB36RNDroQ3weLVAivWtr9BhgEN6g4thEA # j4eJB34c54CSdFolhGCqTWZmEVLpe6VT0lENl4K5qM1++kOK7ZkghTvuchY24ekA # DKGCAigwggIkBgkqhkiG9w0BCQYxggIVMIICEQIBATCBjjB3MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYDVQQDExhNaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0ECEzMAAABZ1nPNUY7wIsUAAAAAAFkwCQYFKw4DAhoFAKBdMBgG # CSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTE0MDgxMzA0 # NDIyMFowIwYJKoZIhvcNAQkEMRYEFPU8Lbovm80g1bwzZNENWiYUrRr2MA0GCSqG # SIb3DQEBBQUABIIBAHVNfkOsoIR1O2pqWXYJS/u6jgIk4sdKAlW/mPvRmOcZ1zxS # eoBFIlE1wwRjQmToIzXYqPGSZF5j5iqW+rx2nZMC3d7nshQ/HtAmBybK95toh/1O # tPGsyZFone7SmP+Qzgt80WyO7T5tV1qgwk/s48Le3lQSF3AztuYUbzD8ENRLfRYF # de1VJtc9oBQhn/R7S+IXFQiPohDSS645ZUCmPaDxAuEmlhn8oLXZ4kvwvam0AfrW # 0jAH4SNCC78mbCo55lPlCi92aq8h+18pyYD7LPsXjxj2QC7pcJ1Cs36gRiD0y9fR # I7p9Ry+7FAWMvtyyxEo9/Jv+sOxqYMMnOmCK3M8= # SIG # End signature block