VoIP:VTX Teams Connect: Difference between revisions

From VTX Public Wiki

(Add info about Kiosk)
(Save ongoing draft)
Line 10: Line 10:
= Requirements =
= Requirements =


You will find below all the needed requirements to use '''VTX Teams Connect''' Service
* A '''VTX Teams Connect''' service
* A '''Microsoft 365''' domain and accounts with the needed Microsoft licenses ( Microsoft Teams + Microsoft 365 Phone System )
* A '''Microsoft Windows PC/Server with Powershell''' app and the needed modules to assign numbers to users ( we are working on an integration in the Kiosk too )

== VTX Teams Connect ==

VTX '''Teams Connect''' service allows a smooth and easy integration between '''Microsoft 365 Teams''' services and the telephony world ( PSTN ) allowing you to use Microsoft service to pass and receive calls using [https://teams.microsoft.com/download Desktop (PC/macOS) or Mobile Teams application (Android/iOS)] or [https://www.vtx.ch dedicated Teams Desktop Phones].
We are using redundant Microsoft validated SBC ('''S'''ession '''B'''order '''C'''ontroller) from Audiocodes to integrate Microsoft Cloud with VTX Telephony platform, and we did automatize the integration to allow flexibility for our partners and customers. As a consequence, no telephony trunk setup is needed on your side.

# Please order a '''VTX Teams Connect''' service from your customer Kiosk inteface with the number of channels and numbers you will need
# You will have a [https://kiosk.vtx.ch VTX Kiosk interface account] from which you will be able to manage and setup your service



== A Microsoft 365 domain and accounts ==


* '''A Microsoft 365 domain and account'''
* '''A Microsoft 365 domain and account'''
Line 30: Line 46:




== Microsoft Windows PC/Server with Powershell ==




{{Notice|1=Powershell + Skype for Business Online can be used from one of the Microsoft Server or Desktop version listed here https://docs.microsoft.com/en-us/SkypeForBusiness/set-up-your-computer-for-windows-powershell/set-up-your-computer-for-windows-powershell}}

= Microsoft Teams Management =


== Connect to Microsoft 365 Admin Portal ==

{{Notice|1=You can use this interfaces for the Domain Management, User management, License management and Software Management}}

* '''Main URL''' : https://admin.microsoft.com/
* '''Domain Management URL''': https://admin.microsoft.com/Adminportal/Home#/Domains
* '''User Management URL''': https://admin.microsoft.com/Adminportal/Home#/users


== Powershell Management Interface ==

{{Notice|1=Unfortunatly, you cannot affect numbers from web interfaces yet, so the IT of your domain will need to use a Windows PC to setup the domain and affect numbers to users}}
{{Notice|1=VTX might provide soon an interface to ease this setup by providing automated scripts or even do it for you}}


=== Install the needed tools ===


# '''(Powershell)''' : Install Powershell your PC https://docs.microsoft.com/en-us/powershell/scripting/install/installing-windows-powershell?view=powershell-7
# '''(Powershell)''' : Install Powershell your PC https://docs.microsoft.com/en-us/powershell/scripting/install/installing-windows-powershell?view=powershell-7
# '''(Microsoft Visual Studio C++)''': Install '''Microsoft Visual Studio C++ 2019 x64''' using https://support.microsoft.com/fr-ch/help/2977003/the-latest-supported-visual-c-downloads
# '''(Microsoft Visual Studio C++)''': Install '''Microsoft Visual Studio C++ 2019 x64''' using https://support.microsoft.com/fr-ch/help/2977003/the-latest-supported-visual-c-downloads
# Install ''Windows Powershell Skype for Business Online module'''
# '''(SkypeOnlineConnector Powershell Module)''' Install ''Windows Powershell Skype for Business Online module'''
## Follow https://docs.microsoft.com/en-us/SkypeForBusiness/set-up-your-computer-for-windows-powershell/set-up-your-computer-for-windows-powershell
## Follow https://docs.microsoft.com/en-us/SkypeForBusiness/set-up-your-computer-for-windows-powershell/set-up-your-computer-for-windows-powershell
## Install Windows Powershell module '''Skype for Business Online module''': https://www.microsoft.com/en-us/download/details.aspx?id=39366
## Install Windows Powershell module '''Skype for Business Online module''': https://www.microsoft.com/en-us/download/details.aspx?id=39366
# (optional) Allow Powershell Execution on your PC to allow to execute '''.ps1''' powershell script provided from Kiosk




''Command to use if you wish to be able to execute '''.ps1''' Powershell scripts that will be available from VTX Kiosk''
=== Allow Powershell Execution on your PC ===
Run this command in Powershell as Admin, cf https://docs.microsoft.com/fr-fr/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-6

<source lang="poweshell">
* Run this command in Powershell as Asmin, cf https://docs.microsoft.com/fr-fr/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-6
PS C:\WINDOWS\system32> Get-ExecutionPolicy
PS C:\WINDOWS\system32> Get-ExecutionPolicy
Restricted
Restricted
PS C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
PS C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Execution Policy Change
Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at https:/go.microsoft.com/fwlink/?LinkID=135170.
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at https:/go.microsoft.com/fwlink/?LinkID=135170.
Line 74: Line 72:


PS C:\WINDOWS\system32> Get-ExecutionPolicy
PS C:\WINDOWS\system32> Get-ExecutionPolicy
RemoteSigned
RemoteSigned
</source>
* Loggout as admin and login again as normal user

* Now you can use the Import-Module Command

''Import SkypeOnlineConnector Powershell module''
<source lang="powershell">
PS C:\WINDOWS\system32> Import-Module SkypeOnlineConnector
PS C:\WINDOWS\system32> Import-Module SkypeOnlineConnector
PS C:\WINDOWS\system32>
PS C:\WINDOWS\system32>
</source>



= Microsoft Teams Management =


== Connect to Microsoft 365 Admin Portal ==

{{Notice|1=You can use this interfaces for the Domain Management, User management, License management and Software Management}}

* '''Main URL''' : https://admin.microsoft.com/
* '''Domain Management URL''': https://admin.microsoft.com/Adminportal/Home#/Domains
* '''User Management URL''': https://admin.microsoft.com/Adminportal/Home#/users


== Powershell Management Interface ==

{{Notice|1=Unfortunatly, you cannot affect numbers from web interfaces yet, so the IT of your domain will need to use a Windows PC to setup the domain and affect numbers to users}}
{{Notice|1=VTX will provide soon an interface to ease this setup by providing automated scripts or we might even do it for you}}

Revision as of 12:48, 22 April 2020

This is a draft used for proposing changes to the article on VoIP:VTX_Teams_Connect.

Some rules:

  • Place this message at the top of all drafts by using {{draft}}. If a draft becomes inactive, replace this message with {{olddraft}}.
  • Do not write drafts as subpages in the main namespace, but do so in the talk namespace. Only import them into the main namespace when they are finished.
  • Do not put these into main categories, but comment these out at the bottom, likewise.
  • If you need to discuss this draft, please do so at Talk:VoIP:VTX Teams Connect.

With VTX Teams Connect, use Microsoft Teams as your main Telephony Solution

VTX Teams Connect

Requirements[edit | edit source]

You will find below all the needed requirements to use VTX Teams Connect Service

  • A VTX Teams Connect service
  • A Microsoft 365 domain and accounts with the needed Microsoft licenses ( Microsoft Teams + Microsoft 365 Phone System )
  • A Microsoft Windows PC/Server with Powershell app and the needed modules to assign numbers to users ( we are working on an integration in the Kiosk too )

VTX Teams Connect[edit | edit source]

VTX Teams Connect service allows a smooth and easy integration between Microsoft 365 Teams services and the telephony world ( PSTN ) allowing you to use Microsoft service to pass and receive calls using Desktop (PC/macOS) or Mobile Teams application (Android/iOS) or dedicated Teams Desktop Phones. We are using redundant Microsoft validated SBC (Session Border Controller) from Audiocodes to integrate Microsoft Cloud with VTX Telephony platform, and we did automatize the integration to allow flexibility for our partners and customers. As a consequence, no telephony trunk setup is needed on your side.

  1. Please order a VTX Teams Connect service from your customer Kiosk inteface with the number of channels and numbers you will need
  2. You will have a VTX Kiosk interface account from which you will be able to manage and setup your service


A Microsoft 365 domain and accounts[edit | edit source]

  • A Microsoft 365 domain and account
    • That will include a Microsoft domain for your enterprise like enterprise.onmicrosoft.com ( or your own enterprise internet name if by example you migrated your emails to Microsoft )
    • A Microsoft 365 Admin account that will be able to buy and affect licenses to your users
  • A Microsoft 365 Domain provided by VTX to you like <servicenumber>.teams.ipvoip.ch ( ex: 123456.teams.ipvoip.ch )
    • To integrate this domain on your account, you can enable it from your Kiosk Interface, FIXME, add link
    • This domain will be used by "VTX Team Connect" service to bridge Microsoft Teams Cloud with VTX VoIP platform using
  • A Microsoft 365 user account teamsadmin@<servicenumber>.teams.ipvoip.ch (using the "VTX Teams Connect" domain provided) with the following Admin Right. It will be used to setup phone numbers on the account using Powershell ( unless VTX can do it for you from the Kiosk )
      • A Microsoft 365 Phone System license ( Temporarily license each time you wish to affect numbers to users )
      • The Microsoft Teams App ( FIXME: Double check if it is till needed )
      • Skype For Business Admin Admin right
      • Teams admin Admin right
      • Teams communication Admin Admin right
      • Teams communication support engineer Admin right
      • Teams communication support specialist Admin right
  • For all your users wishing to have a telephone number
    • A "Microsoft Teams" license ( "Microsoft Teams Commercial Cloud" or Microsoft Teams license included in the E1 or E3 or E5 license )
    • A "Microsoft 365 Phone System" License for any users that will get a phone number


Microsoft Windows PC/Server with Powershell[edit | edit source]

  1. (Powershell) : Install Powershell your PC https://docs.microsoft.com/en-us/powershell/scripting/install/installing-windows-powershell?view=powershell-7
  2. (Microsoft Visual Studio C++): Install Microsoft Visual Studio C++ 2019 x64 using https://support.microsoft.com/fr-ch/help/2977003/the-latest-supported-visual-c-downloads
  3. (SkypeOnlineConnector Powershell Module)' Install Windows Powershell Skype for Business Online module
    1. Follow https://docs.microsoft.com/en-us/SkypeForBusiness/set-up-your-computer-for-windows-powershell/set-up-your-computer-for-windows-powershell
    2. Install Windows Powershell module Skype for Business Online module: https://www.microsoft.com/en-us/download/details.aspx?id=39366
  4. (optional) Allow Powershell Execution on your PC to allow to execute .ps1 powershell script provided from Kiosk


Command to use if you wish to be able to execute .ps1 Powershell scripts that will be available from VTX Kiosk Run this command in Powershell as Admin, cf https://docs.microsoft.com/fr-fr/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-6

 PS C:\WINDOWS\system32> Get-ExecutionPolicy
 Restricted
 
 PS C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
 Execution Policy Change
 The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose   you to the security risks described in the about_Execution_Policies help topic at https:/go.microsoft.com/fwlink/?LinkID=135170.
 Do you want to change the execution policy?
 [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): Y

 PS C:\WINDOWS\system32> Get-ExecutionPolicy 
 RemoteSigned


Import SkypeOnlineConnector Powershell module

 PS C:\WINDOWS\system32> Import-Module SkypeOnlineConnector
 PS C:\WINDOWS\system32>


Microsoft Teams Management[edit | edit source]

Connect to Microsoft 365 Admin Portal[edit | edit source]


Powershell Management Interface[edit | edit source]