Microsoft Teams – Installing PowerShell Preview / Beta Modules (Manage Private Channels)

The Public Preview and Beta modules are useful for testing new features, i.e. managing Private Channel users (Get-TeamChannelUser, Add-TeamChannelUser etc)

Installing Beta Module

Microsoft documentation used to point you to the poshtestgallery.com to get the module. This has now been replaced by the Preview Module however some MS documentation (i.e. Get-TeamChannelUser) still references Posh Test Gallery.

Get-TeamChannelUser advises to use PoshTestGallery.
PoshTestGallery.com

If you try to install a module from Posh Test Gallery you will get the following error:

No match was found for the specified search criteria and module name
‘MicrosoftTeams’.

PoshTestGallery Install-Module -Name MicrosoftTeams ERROR

It would appear over the last couple of weeks (August 2020) the MicrosoftTeams module on PoshTestGallery returns a “404 – Page not found” indicating Microsoft have removed it. The link is still on the home page and is discussed here: https://github.com/PowerShell/PowerShellGallery/issues/119

PoshTestGallery.com 404 not found

Install Public Preview Module

Get-TeamChannelUser still advises to install the Beta module from Posh Test Gallery and Add-TeamsChannelUser advises to install the “Public Preview” version from PowerShell Gallery (I’m sure MS are in the process of updating their documentation):

Add-TeamChannelUser advises to use PowerShell Public Preview

You may get a couple of errors when trying to install the Public Preview module

Install-Module : Cannot process argument transformation on parameter 'RequiredVersion'. Cannot convert value
"1.1.3-preview" to type "System.Version". Error: "Input string was not in a correct format."
RequiredVersion error
Install-Module : A parameter cannot be found that matches parameter name 'AllowPreRelease'.
AllowPreRelease error

The main problem you need to address is AllowPreRelease being missing from Install-Module. This is due to PowerShellGet being out of date on your machine. You would think “Update-Module -Name PowerShellGet” would resolve, but you just get a different error:

Update-Module : Module 'PowerShellGet' was not installed by using Install-Module, so it cannot be updated.

To resolve you have to use Install-Module and specify the -Force switch (Also specify repo if you have multiple installed)

Install-Module -Name PowerShellGet -Repository PSGallery -Force

Once PowerShellGet has been updated, I found I had to open a new PowerShell window before I could install the Teams Preview Module. To install the module run:

Uninstall-Module MicrosoftTeams

Install-Module -Name MicrosoftTeams -RequiredVersion 1.1.3-preview -AllowPrerelease
Install Teams Preview Module

If you run “Get-Command -Name ‘*teamchannel*’ you will see all “TeamChannelUser commands are in the Preview Module.

All *TeamChannel* commands

Leave a Reply

Your email address will not be published. Required fields are marked *

*

This site uses Akismet to reduce spam. Learn how your comment data is processed.