Teams PowerShell datamining - Aug 2021

New updates introduced this summer support video messages in Teams, multi-geo capabilities, and more.

Policies changes

The changes appeared in the outputs of

Messaging

That functionality seems to have been requested many years ago, based on UserVoice entries (currently only available from Google search due to administrative glitch):

Meeting

Calling

Mobility

Cmdlets added temporarily

The following cmdlets were added on the 17th of June and removed on the 16th of July:

• Get-CsTeamsAudioConferencingPolicy
• Grant-CsTeamsAudioConferencingPolicy
• New-CsTeamsAudioConferencingPolicy
• Remove-CsTeamsAudioConferencingPolicy
• Set-CsTeamsAudioConferencingPolicy

All 5 cmdlets were introduced in 2.4.0-preview version and removed in 2.4.1-preview.

Removed cmdlets

Three cmdlets were recently removed:

• New-CsOnlineSession
  - replaced with
  Connect-MicrosoftTeams
• Set-CsGroupPolicyAssignment
• Get-CsInternalModuleVersion

Added cmdlets

Cmdlets from 6 different areas were added in the last few months.

Get-LicenseReportForChangeNotificationSubscription

The cmdlet tells whether the user is capable to export their messages via change notification subscription.

Get-MultiGeoRegion

It allows you to check where user/group data from Teams is stored.

Examples of use:

# User
$userId = (Get-CsOnlineUser 'rob@domain.com').ObjectId
Get-MultiGeoRegion -EntityId $userId -EntityType user

# Group
$groupId = (Get-Teams -DisplayName 'teamName').GroupId
Get-MultiGeoRegion -EntityId $groupId -EntityType group

The cmdlet returns a single object with one property:

CsTeamsCallHoldPolicy cmdlets

The cmdlets which were added are:

• Get-CsTeamsCallHoldPolicy
• Grant-CsTeamsCallHoldPolicy
• New-CsTeamsCallHoldPolicy
• Remove-CsTeamsCallHoldPolicy
• Set-CsTeamsCallHoldPolicy

The documentation for them is not yet available. It's already prepared and waiting to be merged under #7817.

The cmdlets rely on

Call hold policy allows using the custom audio file to be played during the hold. If you want to learn more about music on hold, check Music on hold during Teams call transfer from Erik's blog.

CsOnlineAudioFile cmdlets

Cmdlets added:

• Get-CsOnlineAudioFile
• Remove-CsOnlineAudioFile

These cmdlets are to view and remove audio files. You can add audio files using

Audio files were previously used only in Auto Attendant/Call Queue. Now the support for music on hold for consult transfer is coming (see Roadmap item 82957) and custom audio files will have a new way of use.

Get-Operation

The cmdlet takes two parameters:

TeamsShiftsConnection cmdlets

All cmdlets to manage Shifts connection with third-party workforce management system (WFM). That functionality is currently in private preview with very limited description available.

Cmdlets are:

• Get-CsTeamsShiftsConnectionConnector
• Get-CsTeamsShiftsConnectionInstance
• Get-CsTeamsShiftsConnectionSyncResult
• Get-CsTeamsShiftsConnectionTeamMap
• Get-CsTeamsShiftsConnectionUser
• Get-CsTeamsShiftsConnectionWfmTeam
• New-CsTeamsShiftsConnectionInstance
• New-CsTeamsShiftsConnectionTeamMap
• Remove-CsTeamsShiftsConnectionInstance
• Remove-CsTeamsShiftsConnectionTeamMap
• Set-CsTeamsShiftsConnectionInstance
• Test-CsTeamsShiftsConnectionValidate

Cmdlet params changes

4 cmdlets

Connect-MicrosofTeams

Changes are (newest at the bottom):

• Removed:
  AccessToken
• Added:
  MsAccessToken
  ,
  AadAccessToken
• Added:
  AccessTokens
• Removed:
  MsAccessToken
  ,
  AadAccessToken
• Removed:
  CertificateThumbprint
  ,
  ApplicationId

It's obvious some changes to connection are coming and MS is experimenting to give us better ways to connect.

Grant-CsGroupPolicyPackageAssignment

Added:

Move-CsInternalHelper

Added:

New-CsCustomPolicyPackage

Added:

Summary

Plenty of changes introduced recently. I had a short break with documenting them. This is because of my new side-project, which provides automated and interactive way to view the changes I describe here.

Stay tuned for more updates!