Merge branch 'main' into DLP-chrisda

chrisda · chrisda · commit 8721f153f6f5 · 2025-01-09T14:24:28.000-08:00
diff --git a/teams/teams-ps/teams/Get-TeamTargetingHierarchyStatus.md b/teams/teams-ps/teams/Get-TeamTargetingHierarchyStatus.md
@@ -17,7 +17,7 @@ Get the status of a hierarchy upload (see [Set-TeamTargetingHierarchy](https://l
 
 ### Get (Default)
 ```
-Get-TeamTargetingHierarchyStatus [-RequestId <String>] [<CommonParameters>]
+Get-TeamTargetingHierarchyStatus [-RequestId <String>] [-ApiVersion <String>] [<CommonParameters>]
 ```
 
 ## EXAMPLES
@@ -81,6 +81,23 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ApiVersion
+The version of the Hierarchy APIs to use. Valid values are: 1 or 2.
+
+Currently only available in preview from version 6.6.1-preview. Specifying "-ApiVersion 2" will direct cmdlet requests to the newer version of the Hierarchy APIs. This integration is currently in preview/beta mode so customers should not try it on their production workloads but are welcome to try it on test workloads. This is an optional parameter and not specifying it will be interpreted as specifying "-ApiVersion 1", which will continue to direct cmdlet requests to the original version of the Hierarchy APIs until we upgrade production to v2, at which time we will set the default to 2. We do not expect this to have any impact on your cmdlet usage or existing scripts.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 1
+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).
 
diff --git a/teams/teams-ps/teams/New-CsCallQueue.md b/teams/teams-ps/teams/New-CsCallQueue.md
@@ -40,24 +40,12 @@ The New-CsCallQueue cmdlet creates a new Call Queue.
 > - -NoAgentRedirectPersonAudioFilePrompt
 > - -NoAgentRedirectVoicemailTextToSpeechPrompt
 > - -NoAgentRedirectVoicemailAudioFilePrompt
-> - -IsCallbackEnabled
-> - -CallbackRequestDtmf
-> - -WaitTimeBeforeOfferingCallbackInSecond
-> - -NumberOfCallsInQueueBeforeOfferingCallback
-> - -CallToAgentRatioThresholdBeforeOfferingCallback
-> - -CallbackOfferAudioFilePromptResourceId
-> - -CallbackOfferTextToSpeechPrompt
-> - -CallbackEmailNotificationTarget
 >
 > The following configuration parameters will only work for customers that are participating in the Voice Applications private preview for these features. General Availability for this functionality has not been determined at this time.
 >
 > - -OverflowActionCallPriority
 > - -TimeoutActionCallPriority
 > - -NoAgentActionCallPriority
->
-> The following configuration parameter will only work for customers that are participating in the Queues app private preview for these features. General Availability for this functionality has not been determined at this time.
->
-> - -ServiceLevelThresholdResponseTimeInSecond
 
 ## EXAMPLES
 
@@ -1337,7 +1325,6 @@ Accept wildcard characters: False
 ```
 
 ### -IsCallbackEnabled
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
 The IsCallbackEnabled parameter is used to turn on/off callback.
 
@@ -1354,7 +1341,6 @@ Accept wildcard characters: False
 ```
 
 ### -CallbackRequestDtmf
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
 The DTMF touch-tone key the caller will be told to press to select callback. The CallbackRequestDtmf must be set to one of the following values:
 
@@ -1377,7 +1363,6 @@ Accept wildcard characters: False
 ```
 
 ### -WaitTimeBeforeOfferingCallbackInSecond
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
 The number of seconds a call must wait before becoming eligible for callback. This condition applies to calls at the front of the call queue. Set to null ($null) to disable this condition.
 
@@ -1396,7 +1381,6 @@ Accept wildcard characters: False
 ```
 
 ### -NumberOfCallsInQueueBeforeOfferingCallback
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
 The number of calls in queue before a call becomes eligible for callback. This condition applies to calls arriving at the call queue. Set to null ($null) to disable this condition.
 
@@ -1415,9 +1399,8 @@ Accept wildcard characters: False
 ```
 
 ### -CallToAgentRatioThresholdBeforeOfferingCallback
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
-The ratio of calls to agents that must be in queue before a call becomes eligible for callback. This conditon applies to calls arriving at the call queue. Minimum value of 1. Set to null ($null) to disable this condition.
+The ratio of calls to agents that must be in queue before a call becomes eligible for callback. This condition applies to calls arriving at the call queue. Minimum value of 1. Set to null ($null) to disable this condition.
 
 At least one of `-WaitTimeBeforeOfferingCallbackInSecond`, `-NumberOfCallsInQueueBeforeOfferingCallback`, or `-CallToAgentRatioThresholdBeforeOfferingCallback` must be set to a value other than null when `-IsCallbackEnabled` is `True`.
 
@@ -1434,7 +1417,6 @@ Accept wildcard characters: False
 ```
 
 ### -CallbackOfferAudioFilePromptResourceId
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
 The CallbackOfferAudioFilePromptResourceId parameter indicates the unique identifier for the Audio file prompt which is played to calls that are eligible for callback. This message should tell callers which DTMF touch-tone key (CallbackRequestDtmf) to press to select callback. This parameter, or `-CallbackOfferTextToSpeechPrompt`, becomes a required parameter when IsCallbackEnabled is set to `True`.
 
@@ -1452,7 +1434,6 @@ Accept wildcard characters: False
 ```
 
 ### -CallbackOfferTextToSpeechPrompt
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
 The CallbackOfferTextToSpeechPrompt parameter indicates the Text-to-Speech (TTS) prompt which is played to calls that are eligible for callback. This message should tell callers which DTMF touch-tone key (CallbackRequestDtmf) to press to select callback. This parameter, or `-CallbackOfferAudioFilePromptResourceId`, becomes a required parameter when IsCallbackEnabled is set to `True`.
 
@@ -1470,7 +1451,6 @@ Accept wildcard characters: False
 ```
 
 ### -CallbackEmailNotificationTarget
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
 The CallbackEmailNotificationTarget parameter must be set to a group ID (Microsoft 365, Distribution list, or Mail-enabled security) that will receive notification if a callback times out of the call queue or can't be completed for some other reason. This parameter becomes a required parameter when IsCallbackEnabled is set to `True`.
 
diff --git a/teams/teams-ps/teams/New-CsTeamsCallingPolicy.md b/teams/teams-ps/teams/New-CsTeamsCallingPolicy.md
@@ -396,8 +396,8 @@ Accept wildcard characters: False
 Setting this parameter lets you control how Copilot is used during calls and if transcription is needed to be turned on and saved after the call.
 
 Valid options are:
-- Enabled: Copilot can work with or without transcription during calls. This is the default value.
-- EnabledWithTranscript: Copilot will only work when transcription is enabled during calls.
+- Enabled: Copilot can work with or without transcription during calls.
+- EnabledWithTranscript: Copilot will only work when transcription is enabled during calls. This is the default value.
 - Disabled: Copilot is disabled for calls.
 
 ```yaml
@@ -606,7 +606,8 @@ Accept wildcard characters: False
 ### -PreventTollBypass
 Setting this parameter to True will send calls through PSTN and incur charges rather than going through the network and bypassing the tolls.
 
-**Note**: Do not set this parameter to True for Calling Plan or Operator Connect users as it will prevent successful call routing. This setting only works with Direct Routing which is configured to handle location-based routing restrictions.
+> [!NOTE]
+> Do not set this parameter to True for Calling Plan or Operator Connect users as it will prevent successful call routing. This setting only works with Direct Routing which is configured to handle location-based routing restrictions.
 
 ```yaml
 Type: Boolean
diff --git a/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md b/teams/teams-ps/teams/New-CsTeamsEventsPolicy.md
@@ -18,6 +18,7 @@ New-CsTeamsEventsPolicy [-Identity] <String> [-AllowWebinars <String>] [-AllowTo
 [-RecordingForTownhall <String>] [-RecordingForWebinar <String>]
 [-TranscriptionForTownhall <String>] [-TranscriptionForWebinar <String>]
 [-UseMicrosoftECDN <String>] [-EventAccessType <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
+[-ImmersiveEvents <String>]
 ```
 
 ## DESCRIPTION
@@ -246,6 +247,24 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ImmersiveEvents
+This setting governs if a user can create Immersive Events using Teams Events.
+Possible values are:
+ - **Enabled**: Enables creating Immersive Events.
+ - **Disabled**: Disables creating Immersive Events.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: Enabled
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Confirm
 The Confirm switch does not work with this cmdlet.
 
diff --git a/teams/teams-ps/teams/New-CsTeamsMeetingPolicy.md b/teams/teams-ps/teams/New-CsTeamsMeetingPolicy.md
@@ -64,6 +64,7 @@ New-CsTeamsMeetingPolicy [-Identity] <XdsIdentity>
  [-AllowWatermarkForScreenSharing <Boolean>]
  [-AllowWhiteboard <Boolean>]
  [-AllowedStreamingMediaInput <String>]
+ [-AnonymousUserAuthenticationMethod <String>]
  [-AttendeeIdentityMasking <String>]
  [-AudibleRecordingNotification <String>]
  [-AutoAdmittedUsers <String>]
@@ -874,6 +875,24 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -AnonymousUserAuthenticationMethod
+Determines how anonymous users will be authenticated when joining a meeting.
+
+Possible values are:
+- **OneTimePasscode**, if you would like anonymous users to be sent a one time passcode to their email when joining a meeting
+- **None**, if you would like to disable authentication for anonymous users joining a meeting
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+Required: False
+Position: Named
+Default value: OneTimePasscode
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -AttendeeIdentityMasking
 This setting will allow admins to enable or disable Masked Attendee mode in Meetings. Masked Attendee meetings will hide attendees' identifying information (e.g., name, contact information, profile photo).
 
diff --git a/teams/teams-ps/teams/Remove-TeamTargetingHierarchy.md b/teams/teams-ps/teams/Remove-TeamTargetingHierarchy.md
@@ -17,7 +17,7 @@ Removes the tenant's hierarchy.
 
 ### Remove (Default)
 ```
-Remove-TeamTargetingHierarchy [<CommonParameters>]
+Remove-TeamTargetingHierarchy [-ApiVersion <String>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -30,6 +30,25 @@ Removes the tenant's hierarchy.
 PS C:\> Remove-TeamTargetingHierarchy
 ```
 
+## PARAMETERS
+
+### -ApiVersion
+The version of the Hierarchy APIs to use. Valid values are: 1 or 2.
+
+Currently only available in preview from version 6.6.1-preview. Specifying "-ApiVersion 2" will direct cmdlet requests to the newer version of the Hierarchy APIs. This integration is currently in preview/beta mode so customers should not try it on their production workloads but are welcome to try it on test workloads. This is an optional parameter and not specifying it will be interpreted as specifying "-ApiVersion 1", which will continue to direct cmdlet requests to the original version of the Hierarchy APIs until we upgrade production to v2, at which time we will set the default to 2. We do not expect this to have any impact on your cmdlet usage or existing scripts.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 1
+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).
 
diff --git a/teams/teams-ps/teams/Set-CsOnlineDialInConferencingUser.md b/teams/teams-ps/teams/Set-CsOnlineDialInConferencingUser.md
@@ -4,10 +4,6 @@ online version: https://learn.microsoft.com/powershell/module/teams/set-csonline
 applicable: Microsoft Teams
 title: Set-CsOnlineDialInConferencingUser
 schema: 2.0.0
-manager: bulenteg
-author: tomkau
-ms.author: tomkau
-ms.reviewer: williamlooney
 ---
 
 # Set-CsOnlineDialInConferencingUser
@@ -26,7 +22,7 @@ Use the `Set-CsOnlineDialInConferencingUser` cmdlet to modify the properties of
 Set-CsOnlineDialInConferencingUser [-Identity] <UserIdParameter> [-BridgeId <Guid>]
  [-BridgeName <String>] [-Tenant <Guid>] [-ServiceNumber <String>] [-TollFreeServiceNumber <String>] [-AllowPSTNOnlyMeetings <Boolean>] [-Force]
  [-ResetLeaderPin] [-AllowTollFreeDialIn <Boolean>] [-SendEmailToAddress <String>]
- [-SendEmailFromAddress <String>] [-SendEmailFromDisplayName <String>] [-SendEmail] [-DomainController <Fqdn>]
+ [-SendEmailFromAddress <String>] [-SendEmailFromDisplayName <String>] [-SendEmail] [-DomainController <Fqdn>] [-AsJob]
  [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
@@ -35,7 +31,7 @@ Set-CsOnlineDialInConferencingUser [-Identity] <UserIdParameter> [-BridgeId <Gui
 Set-CsOnlineDialInConferencingUser [-Identity] <UserIdParameter> [-BridgeId <Guid>]
  [-BridgeName <String>] [-TenantDomain <String>] [-ServiceNumber <String>] [-TollFreeServiceNumber <String>] [-AllowPSTNOnlyMeetings <Boolean>] [-Force]
  [-ResetLeaderPin] [-AllowTollFreeDialIn <Boolean>] [-SendEmailToAddress <String>]
- [-SendEmailFromAddress <String>] [-SendEmailFromDisplayName <String>] [-SendEmail] [-DomainController <Fqdn>]
+ [-SendEmailFromAddress <String>] [-SendEmailFromDisplayName <String>] [-SendEmail] [-DomainController <Fqdn>] [-AsJob]
  [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
@@ -374,6 +370,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -AsJob
+The parameter is used to run commands as background jobs. 
+```yaml
+Type: SwitchParameter
+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).
 
diff --git a/teams/teams-ps/teams/Set-CsTeamsCallingPolicy.md b/teams/teams-ps/teams/Set-CsTeamsCallingPolicy.md
@@ -382,9 +382,8 @@ Accept wildcard characters: False
 Setting this parameter lets you control how Copilot is used during calls and if transcription is needed to be turned on and saved after the call.
 
 Valid options are:
-
-- Enabled: Copilot can work with or without transcription during calls. This is the default value.
-- EnabledWithTranscript: Copilot will only work when transcription is enabled during calls.
+- Enabled: Copilot can work with or without transcription during calls.
+- EnabledWithTranscript: Copilot will only work when transcription is enabled during calls. This is the default value.
 - Disabled: Copilot is disabled for calls.
 
 ```yaml
@@ -578,7 +577,8 @@ Accept wildcard characters: False
 ### -PreventTollBypass
 Setting this parameter to True will send calls through PSTN and incur charges rather than going through the network and bypassing the tolls.
 
-**Note**: Do not set this parameter to True for Calling Plan or Operator Connect users as it will prevent successful call routing. This setting only works with Direct Routing which is configured to handle location-based routing restrictions.
+> [!NOTE]
+> Do not set this parameter to True for Calling Plan or Operator Connect users as it will prevent successful call routing. This setting only works with Direct Routing which is configured to handle location-based routing restrictions.
 
 ```yaml
 Type: Boolean
diff --git a/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md b/teams/teams-ps/teams/Set-CsTeamsEventsPolicy.md
@@ -22,6 +22,7 @@ Set-CsTeamsEventsPolicy [-AllowWebinars <String>] [-EventAccessType <String>] [-
  [-TranscriptionForTownhall <String>] [-TranscriptionForWebinar <String>]
  [-UseMicrosoftECDN <Boolean>]
  [-Identity] <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
+ [-ImmersiveEvents <String>]
 ```
 
 ## DESCRIPTION
@@ -369,6 +370,23 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ImmersiveEvents
+This setting governs if a user can create Immersive Events using Teams Events.
+Possible values are:
+ - **Enabled**: Enables creating Immersive Events.
+ - **Disabled**: Disables creating Immersive Events.
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: Enabled
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Confirm
 The Confirm switch does not work with this cmdlet.
 
diff --git a/teams/teams-ps/teams/Set-TeamTargetingHierarchy.md b/teams/teams-ps/teams/Set-TeamTargetingHierarchy.md
@@ -17,7 +17,7 @@ Upload a hierarchy to the tenant. A tenant may only have 1 active hierarchy. Eac
 
 ### Get (Default)
 ```
-Set-TeamTargetingHierarchyStatus [-FilePath <String>] [<CommonParameters>]
+Set-TeamTargetingHierarchyStatus [-FilePath <String>] [-ApiVersion <String>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -61,6 +61,23 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ApiVersion
+The version of the Hierarchy APIs to use. Valid values are: 1 or 2.
+
+Currently only available in preview from version 6.6.1-preview. Specifying "-ApiVersion 2" will direct cmdlet requests to the newer version of the Hierarchy APIs. This integration is currently in preview/beta mode so customers should not try it on their production workloads but are welcome to try it on test workloads. This is an optional parameter and not specifying it will be interpreted as specifying "-ApiVersion 1", which will continue to direct cmdlet requests to the original version of the Hierarchy APIs until we upgrade production to v2, at which time we will set the default to 2. We do not expect this to have any impact on your cmdlet usage or existing scripts.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: 1
+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).
 
