When configuring a Skype for Business Cloud connector you need to fill in the necessary parameters.
Parameters are described in TechNet:
https://technet.microsoft.com/en-us/library/6ce0e580-8c4a-45de-a54f-e39e438335d6#BKMK_SiteParams
I have exported a sample file with Export-CcConfigurationSampleFile for Download: CloudConnector.ini sample file
In the following table you have all the parameters with example data:
Parameter | Info |
[Common] | |
SIPDomains | Domain(s) of SIP URIs used by company users. Domain(s) registered on O365. Support multiple domains separated by space. First domain is the default used for phone URI. Example |
VirtualMachineDomain | Domain DNS suffix for the Skype for Business Cloud Connector Edition itself. Virtual machines CMS, Mediation server join this domain. Can be local (e.g. does not need to be in public DNS). MUST be different with domain(s) registered on O365. Example |
ServerName | AD Server Name. Server name which will be used to generate Server fqdn. It can NOT contain .<VirtualMachineDomain>. 15 Character LIMIT. Example |
IP | AD Server IP address Example |
OnlineSipFederationFqdn | O365 Online service FQDNs. No need to change for world-wide O365 instance. For other instances, go to domain settings page in O365 portal to get the right Fqdns. Default = sipfed.online.lync.com |
SiteName | Must update SiteName before deployment. Register-CcAppliance cmdlet uses SiteName to register current appliance to an existing or new site. If you want to register the appliance to an new site, SiteName must be unique and different from any other existing site in your Office 365 tenant configuration. If you want to register the appliance to an existing site, SiteName must match the site name defined in your Office 365 tenant configuration. If you are copying configuration file from one site to another, make sure you update the SiteName for each site correctly. |
CountryCode | Optional site Parameter |
City | Optional site Parameter |
State | Optional site Parameter |
BaseVMIP | The IP address of the VM that prepares base VM Image. This setting is only necessary for Convert-CcIsoToVhdx. Leave this blank if DHCP is supported. Example |
WSUSServer | The address of Windows Server Update Service – an intranet server to host updates from Microsoft Update. Leave them blank if WSUS is not needed and we’ll update from Windows Update site on the Internet instead |
WSUSStatusServer | |
HardwareType | Type of hardware. The default value is Normal. You can also set to Minimum for smaller deployments that can support up to 50 simultaneous calls. Example |
OMSEnabled | If need to install OMS agent or not. Will automatic install OMS agent during deployment only if OMSEnabled=true. You can call Install-CcOMSAgent anytime to install the OMS agent manually into the running instance. Default = false |
[Network] | |
CorpnetIPPrefixLength | For corpnet IPs Example |
InternetIPPrefixLength | For Edge external IPs Example |
CorpnetSwitchName | The hyper-V switch names for corpnet connectivity. Example |
InternetSwitchName | The hyper-V switch names for internet connectivity. Example |
CorpnetDefaultGateway | Default gateway in Corpnet. Corpnet default gateway enables automatic updating the servers from the Corpnet. It must be configured for Convert-CcIsoToVhdx to convert windows ISO file to VHDX file. Corpnet default gateway will allow BaseVM to connect to internet and install window update packs Example |
InternetDefaultGateway | Internet default gateway to enable edge server to connect O365 Servers. Remove or leave it as blank if don’t want to configure default Gateway Example |
CorpnetDNSIPAddress | DNS IP addresses for corpnet. Use space as separator if there are multiple addresses. This setting is necessary for OS update when WSUS servers are not configured, or they are specified using domain names. This DNS IP address will be added as a forwarder on the AD Server. During Convert-CcIsoToVhdx, this DNS IP address will be assigned to corpnet connection network Adapter. Example |
InternetDNSIPAddress | Internet DNS IP address for resolving _sipfederationtls._tcp.<domain> and _sip._tls.<Domain>. This DNS IP address will be assigned to internet connection network adapter on Edge Server. The Edge server must be able to resolve public DNS records for the O365 Sip Domain. If Gateway FQDN uses O365 Sip Domain in name for TLS purposes, be sure to set this IP Address to allow Edge to resolve these records. Example |
ManagementSwitchName | The management switch to provide network connectivity of host and VMs. Example |
ManagementIPPrefix | ManagementIPPrefix in MUST be configured as different subnet from other internal IPs. Just as the default value shown, ManagementIPPrefix is 192.168.213.0, while AD IPAddress is 192.168.0.238. Default = 192.168.213.0 |
ManagementIPPrefixLength | The ManagementIPPrefixLength should be a value in range [8, 29]. Default = 24 |
[PrimaryCMS] | |
ServerName | Server name which will be used to generate Server fqdn. It can NOT contain .<VirtualMachineDomain>. 15 Character LIMIT. Pool name will be the same as server name. Example |
IP | Server IP address Example |
ShareName | File share name for Primary CMS File Store Service. Must be created on the Primary CMS server (used for replication of CMS data to other servers and backup CMS) Default=CmsFileStore |
[MediationServer] | |
ServerName | Server name which will be used to generate Server fqdn. It can NOT contain .<VirtualMachineDomain>. 15 Character LIMIT. Example |
PoolName | Pool name which will be used to generate pool fqdn. It can NOT contain .<DomainName> Example |
IP | Server IP address Example |
[EdgeServer] | |
InternalServerName | Server name which will be used to generate Server fqdn. It can NOT contain .<VirtualMachineDomain>. 15 Character LIMIT. Example |
InternalPoolName | Pool name which will be used to generate pool fqdn. It can NOT contain .<DomainName> FQDN of the Edge Pool internal interface must resolve to IP addresses on internal interfaces of all edge servers (one A record per Server). Example |
InternalServerIPs | Internal IP addresses of servers in Edge Server Pool. Currently there is only one edge server in Edge Server Pool. We don’t support multiple IP addresses. Example |
ExternalSIPPoolName | Pool name which will be used to generate pool fqdn. It can NOT contain .<DomainName>. FQDN of the Edge Pool external interface for SIP traffic must resolve to IP addresses on external interfaces of all edge servers (one A record per server) or to the VIP of HLB (if HLB is used for SIP traffic). The suffix of this FQDN should be the default (first) internal Domain. The “sip” prefix is not allowed. Example |
ExternalSIPIPs | External IP addresses of servers in Edge Server Pool for SIP traffic. Public IP addresses if there is no NAT (firewall or HLB), NAT-ed addresses otherwise. Currently there is only one edge server in Edge Server Pool. We don’t support multiple IP addresses. Example (NAT) |
ExternalMRFQDNPoolName | Pool name which will be used to generate pool fqdn. It can NOT contain .<DomainName>. FQDN of the Edge Pool external interface for media traffic must resolve to IP addresses on external interfaces of all edge servers (one A record per server) or to the VIP of HLB (if HLB is used for media traffic). Can be the same FQDN as External SIP FQDN (since there is no Client SIP traffic in this topology there is no conflict for port 443). Example |
ExternalMRIPs | External IP addresses of servers in Edge Server Pool for Media traffic. Public IP addresses if there is no NAT or firewall or HLB, NAT-ed addresses otherwise. Can be the same IPs as External SIP IPs (since there is no client SIP traffic in this topology there is no conflict for port 443). Currently there is only one edge server in Edge Server Pool. We don’t support multiple IP addresses. Example (NAT) |
ExternalMRPublicIPs | Public External IP addresses of servers in Edge Server Pool for Media traffic. Should only be specified if NAT (firewall or HLB) is used. If NAT is not used, keep this element here and leave the value as blank. Currently there is only one edge server in Edge Server Pool. We don’t support multiple IP addresses. Example |
ExternalMRPortRange | Public External port range for Media Relay (AV Edge role). MR port start from 50000, the range should be even number from 100 to 10000. For both TCP and UDP. Each concurrent call need 2 ports. So the concurrent call capability in MR should be range / 2. Note: concurrent call number also depends on the capability of PSTN Gateway. Default=10000 |
[Gateway1] | If only one Gateway is needed, remove entire [GateWay2] section. Don’t keep it but leave values empty. If Gateway FQDN uses O365 Sip Domain in name for TLS purposes, be sure to set InternetDNSIPAddress to allow Edge to resolve these records |
FQDN | Gateway FQDN Example (Netstream) |
IP | Gateway IP address Example (Netstream) |
Port | Gateway Port Example (Netstream 5067=TLS, 5068=TCP) |
Protocol | Protocol for SIP traffic (TCP or TLS) Example |
VoiceRoutes | List of voice routes used by this gateway. Routes are defined in the next section. Default=LocalRoute |
[HybridVoiceRoutes] | |
LocalRoute | Named voice route to be used by one or more gateways. Default=.* |
[TrunkConfiguration] | |
EnableReferSupport | Whether Gateways support Refer. It is used for Call Transfer Scenario. The value can be “true” or “false”. Default value is “true”. EnableReferSupport set to “true” means the Gateway(s) support Refer which can handle all the call transfer stuffs. EnableReferSupport set to “false” means the Gateway(s) don’t support Refer. Then Mediation Server will handle all the call transfer stuffs. Example (Netstream) |
EnableFastFailoverTimer | Indicates whether outbound calls that are not answered by the gateway within 10 seconds will be routed to the next available trunk. If there are no additional trunks then the call will automatically be dropped. The value can be “true” or “false”. Default value is “true”. |
ForwardCallHistory | Indicates whether call history information will be forwarded through the trunk. The value can be “true” or “false”. Default value is “false”. Example (Netstream) |
ForwardPAI | Indicates whether the P-Asserted-Identity (PAI) header will be forwarded along with the call. The value can be “true” or “false”. Default value is “false”. Example (Netstream) |