UCLobby Teams PowerShell Module

The module is available in the PowerShell Gallery:
PowerShell Gallery – UCLobbyTeams

Source code available in GitHub:
GitHub – UCLobbyTeams

Get-UcTeamsVersion

Syntax

Get-UcTeamsVersion
-Path
-Computer
-Credential
[<CommonParameters>]

Parameters

• Path- Get Teams Version from previously downloaded log files
• Computer – Specify the computer we want to collect the version from. Requires Admin Shares to be enabled.
• Credential – Credential to be used to connect to the remote computer

Description

The Get-UcTeamsVersion returns the installed Microsoft Teams desktop version for each user profile.

Blog post: Teams: Check client version using PowerShell

Example

Get-UcTeamsVersion
Get-UcTeamsVersion -Path C:\Downloads\
Get-UcTeamsVersion -Computer workstation -Credential (Get-Credential)

Get-UcM365TenantId

Syntax

Get-UcM365TenantId
-Domain
[<CommonParameters>]

Description

This function returns the Tenant ID associated with a domain that is part of a Microsoft 365 Tenant.

Example

Get-UcM365TenantId -Domain uclobby.com

Get-UcTeamsForest

Syntax

Get-UcTeamsForest
-Domain
[<CommonParameters>]

Description

This function returns the forest for a SIP enabled domain.

Blog post: Get-UcTeamsForest

Example

Get-UcTeamsForest -Domain uclobby.com

Get-UcM365Domains

Syntax

Get-UcM365Domains
-Domain
[<CommonParameters>]

Description

This function returns a list of domains that are associated and validated with a Microsoft 365 Tenant.

Example

Get-UcM365Domains -Domain uclobby.com

Test-UcTeamsOnlyModeReadiness

Syntax

Test-UcTeamsOnlyModeReadiness
[-Domain]
[<CommonParameters>]

Description

If we specify the Domain the cmdlet will query all domains associated to the tenant that domain belongs and check one by one.

If the Domain parameter is not specified, it will use the Get-CsSipDomain. This requires that you already connected using Microsoft Teams PowerShell module using Connect-MicrosoftTeams.

Blog Post: Test-UcTeamsOnlyModeReadiness

Examples

Test-UcTeamsOnlyModeReadiness
Test-UcTeamsOnlyModeReadiness -Domain uclobby.com

Get-UcArch

Syntax

Get-UcArch
-FilePath
[<CommonParameters>]

Description

Based on PowerShell script Get-ExecutableType.ps1 by David Wyatt that was originally posted in:

Identify 16-bit, 32-bit and 64-bit executables with PowerShell
https://gallery.technet.microsoft.com/scriptcenter/Identify-16-bit-32-bit-and-522eae75

Example

Get-UcArch -FilePath "C:\Windows\System32\notepad.exe"

Get-UcTeamUsersEmail

Syntax

Get-UcTeamUsersEmail
-TeamName
-Role
[<CommonParameters>]

Description

This function returns a list of users email address that are part of a Team.

If no parameter is specified it will return all users from all teams.

We can also search by team name and which role we want to filter.

Role is limited to Owner, User and Guest.

Example

Get-UcTeamUsersEmail
Get-UcTeamUsersEmail -TeamName "Test Team"
Get-UcTeamUsersEmail -Role Owner

Get-UcTeamsWithSingleOwner

Syntax

Get-UcTeamsWithSingleOwner
[<CommonParameters>]

Description

This function returns a list of Teams that only have a single owner.

Example

Get-UcTeamsWithSingleOwner

Get-UcTeamsDevice

Syntax

Get-UcTeamsDevice
-Filter
-Detailed
[<CommonParameters>]

Description

This function fetch Teams Devices provisioned in a M365 Tenant using MS Graph.

Contributors: David Paulino, Silvio Schanz, Gonçalo Sepulveda, Bryan Kendrick and Daniel Jelinek

Requirements

• Microsoft Graph PowerShell Module (Install-Module Microsoft.Graph)
• Microsoft Graph Scopes:
  • TeamworkDevice.Read.All
  • User.Read.All

Parameters

• Filter
  •     Phone – Teams Native Phones
  •     MTR – Microsoft Teams Rooms running Windows or Android
  •     MTRW – Microsoft Teams Room Running Windows
  •     MTRA – Microsoft Teams Room Running Android
  •     SurfaceHub – Surface Hub
  •     Display – Microsoft Teams Displays
  •     Panel – Microsoft Teams Panels
• Detailed – When present it will get detailed information from Teams Devices
• ExportCSV – Export the results to a CSV file
• OutputPath – Path where the export CSV file should be saved

Example

Get-UcTeamsDevice
Get-UcTeamsDevice -Filter MTR
Get-UcTeamsDevice -Detailed
Get-UcTeamsDevice -ExportCSV
Get-UcTeamsDevice -ExportCSV -OutputPath C:\Reports

Update-UcTeamsDevice

Syntax

Update-UcTeamsDevice
-UpdateType
-DeviceType
-DeviceID
-InputCSV
-Subnet
-OutputPath
-ReportOnly
[<CommonParameters>]

Description

This allows Teams administrators to send update commands to multiple Teams Android Devices using MS Graph API.

Contributors Eileen Beato, David Paulino and Bryan Kendrick.

Requirements

• Microsoft Graph PowerShell Module (Install-Module Microsoft.Graph)
• Microsoft Graph Scopes:
  • TeamworkDevice.ReadWrite.All

Parameters

• UpdateType
  • Firmware
  • TeamsApp
• DeviceType
  • Phone – Teams Native Phones
  • MTRA – Microsoft Teams Room Running Android
  • Display – Microsoft Teams Displays
  • Panel – Microsoft Teams Panels
• DeviceID – Specify the Teams Admin Center Device ID that we want to update.
• InputCSV – When present will use this file as Input, we only need a column with Device Id. It supports files exported from Teams Admin Center (TAC).
• Subnet – Only available when using InputCSV and requires a “IP Address” column, it allows to only send updates to Teams Android devices within a subnet. Format examples: 10.0.0.0/8, 192.168.0.0/24
• OutputPath – Path where the export CSV file should be saved
• ReportOnly – Will read Teams Device Android versions info and generate a report.

Example

Update-UcTeamsDevice
Update-UcTeamsDevice -ReportOnly
Update-UcTeamsDevice -InputCSV C:\UCLobby\DevicesList.csv -Subnet 10.10.0.0/16

Test-UcTeamsDevicesConditionalAccessPolicy

Syntax

Test-UcTeamsDevicesConditionalAccessPolicy
-Detailed
[<CommonParameters>]

Description

This function will validate each setting in a Conditional Access Policy to make sure they are in line with the supported settings:

Teams Android Devices – Supported Conditional Access policies

Contributors: Traci Herr, David Paulino

More info:

UCMESS: How to Check Conditional Access Policies unsupported settings for the Teams Android Devices

Requirements

• Microsoft Graph PowerShell Module (Install-Module Microsoft.Graph)
• Microsoft Graph Scopes:
  • Policy.Read.All

Parameters

• Detailed – When present it will get detailed configuration information from Condicional Access policy

Example

Test-UcTeamsDevicesConditionalAccessPolicy
Test-UcTeamsDevicesConditionalAccessPolicy -Detailed

Test-UcTeamsDevicesCompliancePolicy

Syntax

Test-UcTeamsDevicesCompliancePolicy
-Detailed
[<CommonParameters>]

Description

This function will validate each setting in the Intune Compliance Policy to make sure they are in line with the supported settings:

Teams Android Devices – Supported Intune Compliance policies

Contributors: Traci Herr, David Paulino

UCMESS: Checking Intune Compliance Policies for unsupported settings

Requirements

• Microsoft Graph PowerShell Module (Install-Module Microsoft.Graph)
• Microsoft Graph Scopes:
  • DeviceManagementConfiguration.Read.All

Parameters

• Detailed – When present it will get detailed configuration information from Intune Compliance policy

Example

Test-UcTeamsDevicesCompliancePolicy
Test-UcTeamsDevicesCompliancePolicy -Detailed