Update policy documents

teams/teams-ps/MicrosoftTeams/Get-CsTeamsRecordingAndTranscriptionCustomMessage.md

@@ -0,0 +1,56 @@
+---
+author: dlb233
+Locale: en-US
+Module Name: MicrosoftTeams
+ms.author: lingbodu
+online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-CsTeamsRecordingAndTranscriptionCustomMessage
+schema: 2.0.0
+title: Get-CsTeamsRecordingAndTranscriptionCustomMessage
+---
+
+# Get-CsTeamsRecordingAndTranscriptionCustomMessage
+
+> [!NOTE]
+> This feature has not been fully released yet, so the setting will have no effect.
+
+## SYNOPSIS
+Return information about the instance of TeamsRecordingAndTranscriptionCustomMessage that have been configured for recording and transcription customized message.
+
+## SYNTAX
+
+### Identity (Default)
+```
+Get-CsTeamsRecordingAndTranscriptionCustomMessage [-Id <Guid>]
+```
+
+## DESCRIPTION
+
+The strings defined in TeamsRecordingAndTranscriptionCustomMessage is used for display after recording or transcription is started in a meeting. 
+Based on the different scenarios when recording or transcription is enabled, we provide different keys for customization, as detailed below. 
+These strings will not take effect immediately after being created; they need to be associated with other configurations and policies.
+
+This command will return existing TeamsRecordingAndTranscriptionCustomMessage by your input condition that have been configured before with New-CsTeamsRecordingAndTranscriptionCustomMessage.
+
+## EXAMPLES
+
+### Example 1
+```
+PS C:\> Get-CsTeamsRecordingAndTranscriptionCustomMessage
+```
+The command shown in Example 1 returns information for all the instances of TeamsRecordingAndTranscriptionCustomMessage that have been created.
+
+### Example 2
+```
+PS C:\> Get-CsTeamsRecordingAndTranscriptionCustomMessage -Id '39dc3ede-c80e-4f19-9153-417a65a1f144'
+```
+In Example 2, information is returned for a single instance of a TeamsRecordingAndTranscriptionCustomMessage with the Id 39dc3ede-c80e-4f19-9153-417a65a1f144.
+
+## RELATED LINKS
+
+[New-CsTeamsRecordingAndTranscriptionCustomMessage](https://learn.microsoft.com/powershell/module/microsoftteams/new-CsTeamsRecordingAndTranscriptionCustomMessage)
+
+[Set-CsTeamsRecordingAndTranscriptionCustomMessage](https://learn.microsoft.com/powershell/module/microsoftteams/set-CsTeamsRecordingAndTranscriptionCustomMessage)
+
+[Remove-CsTeamsRecordingAndTranscriptionCustomMessage](https://learn.microsoft.com/powershell/module/microsoftteams/remove-CsTeamsRecordingAndTranscriptionCustomMessage)
+
+[New-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage](https://learn.microsoft.com/powershell/module/microsoftteams/new-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage)

teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md

@@ -326,6 +326,9 @@ The CsTeamsCortanaPolicy cmdlets enable administrators to control settings for C
 ### [Get-CsTeamsCustomBannerText](Get-CsTeamsCustomBannerText.md)
 Enables administrators to configure a custom text on the banner displayed when compliance recording bots start recording the call.
 
+### [Get-CsTeamsRecordingAndTranscriptionCustomMessage](Get-CsTeamsRecordingAndTranscriptionCustomMessage.md)
+This cmdlet allows IT admins to retrieve information about the instance of TeamsRecordingAndTranscriptionCustomMessage that have been configured for recording and transcription customized message.
+
 ### [Get-CsTeamsEducationAssignmentsAppPolicy](Get-CsTeamsEducationAssignmentsAppPolicy.md)
 This cmdlet allows you to retrieve the current values of your Education Assignments App Policy.
 
@@ -953,6 +956,12 @@ The CsTeamsCortanaPolicy cmdlets enable administrators to control settings for C
 ### [New-CsTeamsCustomBannerText](New-CsTeamsCustomBannerText.md)
 Enables administrators to configure a custom text on the banner displayed when compliance recording bots start recording the call.
 
+### [New-CsTeamsRecordingAndTranscriptionCustomMessage](New-CsTeamsRecordingAndTranscriptionCustomMessage.md)
+Create a concrete prompt message setting in multiple languages and multiple scenarios to be displayed to participants after recording or transcription has started.
+
+### [New-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage](New-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage.md)
+Create a set of language-specific prompt messages to be displayed to participants after recording or transcription has started. 
+
 ### [New-CsTeamsEmergencyCallingExtendedNotification](New-CsTeamsEmergencyCallingExtendedNotification.md)
 {{Placeholder}}
 
@@ -1244,6 +1253,9 @@ The CsTeamsCortanaPolicy cmdlets enable administrators to control settings for C
 ### [Remove-CsTeamsCustomBannerText](Remove-CsTeamsCustomBannerText.md)
 Enables administrators to remove a custom banner text configuration that is displayed when compliance recording bots start recording the call.
 
+### [Remove-CsTeamsRecordingAndTranscriptionCustomMessage](Remove-CsTeamsRecordingAndTranscriptionCustomMessage.md)
+Remove information about the instance of TeamsRecordingAndTranscriptionCustomMessage that have been configured for recording and transcription customized message.
+
 ### [Remove-CsTeamsEmergencyCallingPolicy](Remove-CsTeamsEmergencyCallingPolicy.md)
 {{Placeholder}}
 
@@ -1565,6 +1577,9 @@ The CsTeamsCortanaPolicy cmdlets enable administrators to control settings for C
 ### [Set-CsTeamsCustomBannerText](Set-CsTeamsCustomBannerText.md)
 Enables administrators to update a configured custom text on the banner displayed when compliance recording bots start recording the call.
 
+### [Set-CsTeamsRecordingAndTranscriptionCustomMessage](Set-CsTeamsRecordingAndTranscriptionCustomMessage.md)
+Change an existing TeamsRecordingAndTranscriptionCustomMessage settings in your tenant
+
 ### [Set-CsTeamsEducationAssignmentsAppPolicy](Set-CsTeamsEducationAssignmentsAppPolicy.md)
 This policy is controlled by Global and Teams Service Administrators, and is used to turn on/off certain features only related to the Assignments Service, which runs for tenants with EDU licenses.
 

teams/teams-ps/MicrosoftTeams/New-CsTeamsCallingPolicy.md

@@ -56,6 +56,8 @@ New-CsTeamsCallingPolicy [-Identity] <string>
  [-RealTimeText <string>]
  [-ExplicitRecordingConsent <string>]
  [-WhatIf]
+ [-EnableRecordingAndTranscriptionCustomMessage <Boolean>]
+ [-RecordingAndTranscriptionCustomMessageIdentifier <Guid>]
  [<CommonParameters>]
 ```
 
@@ -798,6 +800,40 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -EnableRecordingAndTranscriptionCustomMessage
+> [!NOTE]
+> This feature has not been fully released yet, so the setting will have no effect.
+This policy controls whether custom strings can be shown for recording and transcription in user's Teams calls. It need to work with RecordingAndTranscriptionCustomMessageIdentifier.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -RecordingAndTranscriptionCustomMessageIdentifier
+> [!NOTE]
+> This feature has not been fully released yet, so the setting will have no effect.
+This attribute holds the unique identifier for the custom recording and transcription calling message. It stores a GUID that points to the CustomMessage in TeamsCustomMessageConfiguration.
+
+```yaml
+Type: Guid
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### CommonParameters
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
 

teams/teams-ps/MicrosoftTeams/New-CsTeamsMeetingPolicy.md

@@ -125,6 +125,8 @@ New-CsTeamsMeetingPolicy [-Identity] <XdsIdentity>
  [-ParticipantSlideControl <string>]
  [-WhatIf]
  [-WhoCanRegister <Object>]
+ [-EnableRecordingAndTranscriptionCustomMessage <Boolean>]
+ [-RecordingAndTranscriptionCustomMessageIdentifier <Guid>]
  [<CommonParameters>]
 ```
 
@@ -1981,6 +1983,40 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -EnableRecordingAndTranscriptionCustomMessage
+> [!NOTE]
+> This feature has not been fully released yet, so the setting will have no effect.
+This policy controls whether custom strings can be shown for recording and transcription in user's Teams meetings. It need to work with RecordingAndTranscriptionCustomMessageIdentifier.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -RecordingAndTranscriptionCustomMessageIdentifier
+> [!NOTE]
+> This feature has not been fully released yet, so the setting will have no effect.
+This attribute holds the unique identifier for the custom recording and transcription meeting message. It stores a GUID that points to the CustomMessage in TeamsCustomMessageConfiguration.
+
+```yaml
+Type: Guid
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### CommonParameters
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216).
 

teams/teams-ps/MicrosoftTeams/New-CsTeamsRecordingAndTranscriptionCustomMessage.md

@@ -0,0 +1,90 @@
+---
+author: dlb233
+Locale: en-US
+Module Name: MicrosoftTeams
+ms.author: lingbodu
+online version: https://learn.microsoft.com/powershell/module/microsoftteams/new-CsTeamsRecordingAndTranscriptionCustomMessage
+schema: 2.0.0
+title: New-CsTeamsRecordingAndTranscriptionCustomMessage
+---
+
+# New-CsTeamsRecordingAndTranscriptionCustomMessage
+
+> [!NOTE]
+> This feature has not been fully released yet, so the setting will have no effect.
+
+## SYNOPSIS
+
+Create a concrete prompt message setting in multiple languages and multiple scenarios to be displayed to participants after recording or transcription has started.
+## SYNTAX
+
+```
+New-CsTeamsRecordingAndTranscriptionCustomMessage
+ [-Id <System.Guid>]
+ [-Description <String>]
+ [-RecordingAndTranscriptionLocalizationCustomMessage <RecordingAndTranscriptionLocalizationCustomMessage>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+The strings defined by this command is used for display after recording or transcription is started in a meeting. 
+Based on the different scenarios when recording or transcription is enabled, we provide different keys for customization, as detailed below. 
+These strings will not take effect immediately after being created; they need to be associated with other configurations and policies.
+
+This command will define a complete custom message override policy that can be directly assigned to users. 
+It specifies the In-meeting notification(UFD) prompt content that users with different roles will see in six different scenarios when starting recording and transcription, across various language environments.
+After this configuration is successfully completed, you can assign the generated Id to the user’s RecordingAndTranscriptionCustomMessageIdentifier field to apply the policy to that user. Afterwards, in meetings hosted by this user, once the language and scenario match, participants will see the new In-meeting notification(UFD) message customized by this command.
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> New-CsTeamsRecordingAndTranscriptionCustomMessage -Id '39dc3ede-c80e-4f19-9153-417a65a1f144'
+```
+
+The command shown in Example 1 creates an in-memory instance of a CsTeamsRecordingAndTranscriptionCustomMessage with no content. It can be set to RecordingAndTranscriptionCustomMessageIdentifier but nothing will change.
+
+### Example 2
+```
+$en = New-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage -Language "en-US" -InitiatorImplicit "This call is being recorded." -ParticipantImplicit "This call is being recorded."
+>> $zh = New-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage -Language "zh-CN" -InitiatorExplicit "请注意，此通话正在录音。" -ParticipantExplicitRequested "此通话正在录音，我们将在得到您同意后再录制你的声音。"
+>> New-CsTeamsRecordingAndTranscriptionCustomMessage -Description "Multi languages record custom message" -RecordingAndTranscriptionLocalizationCustomMessage @($en, $zh)
+```
+Example 2 demonstrates a complete case, defining the recording and transcription prompt messages that users see in English and Chinese under different scenarios.
+If such policy applied to the meeting organizer, then:
+- Current user is recording/transcription intiator, Teams language is English US", the meeting organizer doesn't enable consent recording/transcription, when current user start recording or transcript, he/she will see "This call is being recorded.".
+- Current user is normal participant, Teams language is English US, the meeting organizer doesn't enable consent recording/transcription, when recording or transcript started, current user will see "This call is being recorded."
+- Current user is recording/transcription intiator, Teams language is Chinese simplify, the meeting organizer enable the consent recording/transcription, when current user start recording or transcript,  he/she will see "请注意，此通话正在录音。"
+- Current user is normal participant, Teams language is Chinese simplify, the meeting organizer enable the consent recording/transcription，after someone started recording or transcription, he will see "此通话正在录音，我们将在得到您同意后再录制你的声音。"
+
+## Parameters
+### -Id
+The ObjectId of the CsTeamsRecordingAndTranscriptionCustomMessage setting, By assigning the ID to the **RecordingAndTranscriptionCustomMessageIdentifier** field in the meeting policy or calling policy, you can associate the current custom prompt message configuration with a user group or individual users.
+
+At the same time, when creating CsTeamsRecordingAndTranscriptionCustomMessage, it is not necessary to explicitly specify the ID; a GUID will be automatically generated and stored as the Id.
+
+### -DESCRIPTION
+Add a description for CsTeamsRecordingAndTranscriptionCustomMessage.
+
+### -RecordingAndTranscriptionLocalizationCustomMessage
+Set the specific recording and transcription prompt messages to be customized. The type is a list of TeamsRecordingAndTranscriptionLocalizationCustomMessage, with each element in the list representing a custom message for a particular language. For more information, please refer to New-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage.
+```yaml
+Type: TeamsRecordingAndTranscriptionLocalizationCustomMessage[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+## RELATED LINKS
+[Set-CsTeamsRecordingAndTranscriptionCustomMessage](https://learn.microsoft.com/powershell/module/microsoftteams/set-CsTeamsRecordingAndTranscriptionCustomMessage)
+
+[Get-CsTeamsRecordingAndTranscriptionCustomMessage](https://learn.microsoft.com/powershell/module/microsoftteams/Get-CsTeamsRecordingAndTranscriptionCustomMessage)
+
+[Remove-CsTeamsRecordingAndTranscriptionCustomMessage](https://learn.microsoft.com/powershell/module/microsoftteams/remove-CsTeamsRecordingAndTranscriptionCustomMessage)
+
+[New-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage](https://learn.microsoft.com/powershell/module/microsoftteams/new-CsTeamsRecordingAndTranscriptionLocalizationCustomMessage)