From 4d32c0a1a9a764b38b25467d823ae0675682a100 Mon Sep 17 00:00:00 2001 From: Andy Wang Date: Mon, 24 Mar 2025 13:55:57 -0700 Subject: [PATCH 1/3] Update Teams AI Policy cmdlets docs with SpeakerAttributionBYOD --- teams/teams-ps/teams/Get-CsTeamsAIPolicy.md | 4 +- teams/teams-ps/teams/Grant-CsTeamsAIPolicy.md | 2 +- teams/teams-ps/teams/New-CsTeamsAIPolicy.md | 24 ++++++++- .../teams-ps/teams/Remove-CsTeamsAIPolicy.md | 2 +- teams/teams-ps/teams/Set-CsTeamsAIPolicy.md | 49 ++++++++++++++++--- 5 files changed, 69 insertions(+), 12 deletions(-) diff --git a/teams/teams-ps/teams/Get-CsTeamsAIPolicy.md b/teams/teams-ps/teams/Get-CsTeamsAIPolicy.md index 31df8e82df..77a631f12f 100644 --- a/teams/teams-ps/teams/Get-CsTeamsAIPolicy.md +++ b/teams/teams-ps/teams/Get-CsTeamsAIPolicy.md @@ -23,7 +23,7 @@ Get-CsTeamsAIPolicy [[-Identity] ] [-Filter ] [ Get-CsTeamsAIPolicy ``` -Retrieves Teams AI policies and shows "EnrollFace" and "EnrollVoice" values. +Retrieves Teams AI policies and shows "EnrollFace", "EnrollVoice" and "SpeakerAttributionBYOD" values. ## PARAMETERS diff --git a/teams/teams-ps/teams/Grant-CsTeamsAIPolicy.md b/teams/teams-ps/teams/Grant-CsTeamsAIPolicy.md index e4da7ca635..4b3575f42c 100644 --- a/teams/teams-ps/teams/Grant-CsTeamsAIPolicy.md +++ b/teams/teams-ps/teams/Grant-CsTeamsAIPolicy.md @@ -39,7 +39,7 @@ Grant-CsTeamsAIPolicy [[-PolicyName] ] [-Global] [-Force] [ [-EnrollFace ] [-EnrollVoice ] [-Description ] [] +New-CsTeamsAIPolicy -Identity + [-EnrollFace ] + [-EnrollVoice ] + [-SpeakerAttributionBYOD ] + [-Description ] + [] ``` ## DESCRIPTION -The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs. +The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. A new setting, SpeakerAttributionBYOD, is also being added to csTeamsAIPolicy. This allows IT admins to turn off speaker attribution in BYOD scenarios, giving them greater control over how voice data is managed in such environments. This setting can be set to Enabled or Disabled, and will be Enabled by default. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs. This cmdlet creates a Teams AI policy. If you get an error that the policy already exists, it means that the policy already exists for your tenant. In this case, run Get-CsTeamsAIPolicy. @@ -82,6 +87,21 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -SpeakerAttributionBYOD +Policy value of the Teams AI SpeakerAttributionBYOD policy. SpeakerAttributionBYOD controls usage of speaker attribution in BYOD scenarios in Teams. + +```yaml +Type: Boolean +Parameter Sets: ("Enabled","Disabled") +Aliases: + +Required: True +Position: Named +Default value: Enabled +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Description Enables administrators to provide explanatory text about the Teams AI policy. For example, the Description might indicate the users the policy should be assigned to. diff --git a/teams/teams-ps/teams/Remove-CsTeamsAIPolicy.md b/teams/teams-ps/teams/Remove-CsTeamsAIPolicy.md index 655f12b5b5..01ddbc1bcc 100644 --- a/teams/teams-ps/teams/Remove-CsTeamsAIPolicy.md +++ b/teams/teams-ps/teams/Remove-CsTeamsAIPolicy.md @@ -23,7 +23,7 @@ Remove-CsTeamsAIPolicy -Identity [] ## DESCRIPTION -The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs. +The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. A new setting, SpeakerAttributionBYOD, is also being added to csTeamsAIPolicy. This allows IT admins to turn off speaker attribution in BYOD scenarios, giving them greater control over how voice data is managed in such environments. This setting can be set to Enabled or Disabled, and will be Enabled by default. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs. This cmdlet deletes a Teams AI policy with the specified identity string. diff --git a/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md b/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md index f72a598f5b..1756ff1255 100644 --- a/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md +++ b/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md @@ -17,19 +17,20 @@ This cmdlet sets Teams AI policy value for users in the tenant. ## SYNTAX -``` +```powershell Set-CsTeamsAIPolicy [[-Identity] ] [-EnrollFace ] [-EnrollVoice ] + [-SpeakerAttributionBYOD ] [-Description ] [] ``` ## DESCRIPTION -The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs. +The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. A new setting, SpeakerAttributionBYOD, is also being added to csTeamsAIPolicy. This allows IT admins to turn off speaker attribution in BYOD scenarios, giving them greater control over how voice data is managed in such environments. This setting can be set to Enabled or Disabled, and will be Enabled by default. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs. -This cmdlet sets the Teams AI policy EnrollFace and EnrollVoice value for the tenant. The values of EnrollFace and EnrollVoice can be set to "Enabled" or "Disabled". +This cmdlet sets the EnrollFace, EnrollVoice, and SpeakerAttributionBYOD values within the csTeamsAIPolicy. These policies can be assigned to users, and each setting can be configured as "Enabled" or "Disabled". " ## EXAMPLES @@ -49,32 +50,53 @@ Set Teams AI policy "EnrollVoice" value to "Disabled" for global as default. ### Example 3 ```powershell +PS C:\> Set-CsTeamsAIPolicy -Identity Global -SpeakerAttributionBYOD Disabled +``` + +Set Teams AI policy "SpeakerAttributionBYOD" value to "Disabled" for global as default. + +### Example 4 +```powershell PS C:\> Set-CsTeamsAIPolicy -Identity Test -EnrollFace Enabled ``` Set Teams AI policy "EnrollFace" value to "Enabled" for identity "Test". -### Example 4 +### Example 5 ```powershell PS C:\> Set-CsTeamsAIPolicy -Identity Test -EnrollVoice Enabled ``` Set Teams AI policy "EnrollVoice" value to "Enabled" for identity "Test". -### Example 5 +### Example 6 +```powershell +PS C:\> Set-CsTeamsAIPolicy -Identity Test -SpeakerAttributionBYOD Enabled +``` + +Set Teams AI policy "SpeakerAttributionBYOD" value to "Enabled" for identity "Test". + +### Example 7 ```powershell PS C:\> Set-CsTeamsAIPolicy -Identity Test -EnrollFace Disabled ``` Set Teams AI policy "EnrollFace" value to "Disabled" for identity "Test". -### Example 6 +### Example 8 ```powershell PS C:\> Set-CsTeamsAIPolicy -Identity Test -EnrollVoice Disabled ``` Set Teams AI policy "EnrollVoice" value to "Disabled" for identity "Test". +### Example 9 +```powershell +PS C:\> Set-CsTeamsAIPolicy -Identity Test -SpeakerAttributionBYOD Disabled +``` + +Set Teams AI policy "SpeakerAttributionBYOD" value to "Disabled" for identity "Test". + ## PARAMETERS ### -Identity @@ -122,6 +144,21 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -SpeakerAttributionBYOD +Policy value of the Teams AI SpeakerAttributionBYOD policy. SpeakerAttributionBYOD controls usage of speaker attribution in BYOD scenarios in Teams. + +```yaml +Type: Boolean +Parameter Sets: ("Enabled","Disabled") +Aliases: + +Required: True +Position: Named +Default value: Enabled +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Description Enables administrators to provide explanatory text about the Teams AI policy. For example, the Description might indicate the users the policy should be assigned to. From 9c4267cb8028abf47611818f5959df07ee5eead1 Mon Sep 17 00:00:00 2001 From: Andy Wang Date: Tue, 25 Mar 2025 08:50:53 -0700 Subject: [PATCH 2/3] Addressed comments --- teams/teams-ps/teams/New-CsTeamsAIPolicy.md | 2 +- teams/teams-ps/teams/Set-CsTeamsAIPolicy.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/teams/New-CsTeamsAIPolicy.md b/teams/teams-ps/teams/New-CsTeamsAIPolicy.md index efdcf736ae..41b9a72180 100644 --- a/teams/teams-ps/teams/New-CsTeamsAIPolicy.md +++ b/teams/teams-ps/teams/New-CsTeamsAIPolicy.md @@ -88,7 +88,7 @@ Accept wildcard characters: False ``` ### -SpeakerAttributionBYOD -Policy value of the Teams AI SpeakerAttributionBYOD policy. SpeakerAttributionBYOD controls usage of speaker attribution in BYOD scenarios in Teams. +Policy value of the Teams AI SpeakerAttributionBYOD policy. Setting to "Enabled" turns on speaker attribution in BYOD scenarios while "Disabled" will turn off the function. ```yaml Type: Boolean diff --git a/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md b/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md index 1756ff1255..3bc7c3ab99 100644 --- a/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md +++ b/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md @@ -145,7 +145,7 @@ Accept wildcard characters: False ``` ### -SpeakerAttributionBYOD -Policy value of the Teams AI SpeakerAttributionBYOD policy. SpeakerAttributionBYOD controls usage of speaker attribution in BYOD scenarios in Teams. +Policy value of the Teams AI SpeakerAttributionBYOD policy. Setting to "Enabled" turns on speaker attribution in BYOD scenarios while "Disabled" will turn off the function. ```yaml Type: Boolean From 0ff3f81d7ebe4b6d42bcf2c7ace81a8ce388b80a Mon Sep 17 00:00:00 2001 From: Andy Wang Date: Tue, 25 Mar 2025 10:23:10 -0700 Subject: [PATCH 3/3] Fix type --- teams/teams-ps/teams/New-CsTeamsAIPolicy.md | 12 ++++++------ teams/teams-ps/teams/Set-CsTeamsAIPolicy.md | 12 ++++++------ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/teams/teams-ps/teams/New-CsTeamsAIPolicy.md b/teams/teams-ps/teams/New-CsTeamsAIPolicy.md index 41b9a72180..4a7ff4af67 100644 --- a/teams/teams-ps/teams/New-CsTeamsAIPolicy.md +++ b/teams/teams-ps/teams/New-CsTeamsAIPolicy.md @@ -18,9 +18,9 @@ This cmdlet creates a Teams AI policy. ```powershell New-CsTeamsAIPolicy -Identity - [-EnrollFace ] - [-EnrollVoice ] - [-SpeakerAttributionBYOD ] + [-EnrollFace ] + [-EnrollVoice ] + [-SpeakerAttributionBYOD ] [-Description ] [] ``` @@ -61,7 +61,7 @@ Accept wildcard characters: False Policy value of the Teams AI EnrollFace policy. EnrollFace controls user access to user face enrollment in the Teams app settings. ```yaml -Type: Boolean +Type: String Parameter Sets: ("Enabled","Disabled") Aliases: @@ -76,7 +76,7 @@ Accept wildcard characters: False Policy value of the Teams AI EnrollVoice policy. EnrollVoice controls user access to user voice enrollment in the Teams app settings. ```yaml -Type: Boolean +Type: String Parameter Sets: ("Enabled","Disabled") Aliases: @@ -91,7 +91,7 @@ Accept wildcard characters: False Policy value of the Teams AI SpeakerAttributionBYOD policy. Setting to "Enabled" turns on speaker attribution in BYOD scenarios while "Disabled" will turn off the function. ```yaml -Type: Boolean +Type: String Parameter Sets: ("Enabled","Disabled") Aliases: diff --git a/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md b/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md index 3bc7c3ab99..2c43c43e51 100644 --- a/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md +++ b/teams/teams-ps/teams/Set-CsTeamsAIPolicy.md @@ -19,9 +19,9 @@ This cmdlet sets Teams AI policy value for users in the tenant. ```powershell Set-CsTeamsAIPolicy [[-Identity] ] - [-EnrollFace ] - [-EnrollVoice ] - [-SpeakerAttributionBYOD ] + [-EnrollFace ] + [-EnrollVoice ] + [-SpeakerAttributionBYOD ] [-Description ] [] ``` @@ -118,7 +118,7 @@ Accept wildcard characters: False Policy value of the Teams AI EnrollFace policy. EnrollFace controls user access to user face enrollment in the Teams app settings. ```yaml -Type: Boolean +Type: String Parameter Sets: ("Enabled","Disabled") Aliases: @@ -133,7 +133,7 @@ Accept wildcard characters: False Policy value of the Teams AI EnrollVoice policy. EnrollVoice controls user access to user voice enrollment in the Teams app settings. ```yaml -Type: Boolean +Type: String Parameter Sets: ("Enabled","Disabled") Aliases: @@ -148,7 +148,7 @@ Accept wildcard characters: False Policy value of the Teams AI SpeakerAttributionBYOD policy. Setting to "Enabled" turns on speaker attribution in BYOD scenarios while "Disabled" will turn off the function. ```yaml -Type: Boolean +Type: String Parameter Sets: ("Enabled","Disabled") Aliases: