Merge branch 'main' into Grace-chrisda

chrisda · chrisda · commit 002a1bddcb8e · 2024-11-05T09:08:27.000-08:00
diff --git a/README.md b/README.md
@@ -32,7 +32,7 @@ Contributors who make infrequent or small updates can edit the file directly on
    Articles on learn.microsoft.com are formatted using the Markdown language. For help on using Markdown, see [Mastering Markdown](https://guides.github.com/features/mastering-markdown/).
 
    > [!TIP]
-   > Cmdlet reference articles follow a very strict schema with limited formatting options, because the articles are also converted and used for help at the command line (`Get-Help <CmdletName`). Use existing content as a guide. For more information, see [platyPS Schema](https://github.com/PowerShell/platyPS/blob/master/platyPS.schema.md).
+   > Cmdlet reference articles follow a very strict schema with limited formatting options, because the articles are also converted and used for help at the command line (`Get-Help <CmdletName`). Use existing content as a guide. For more information, see [platyPS Schema](https://github.com/PowerShell/platyPS/blob/master/docs/developer/platyPS/platyPS.schema.md).
 
    Select **Preview** to view your changes as you go. Select **Edit** to go back to making updates.
 
diff --git a/exchange/exchange-ps/exchange/Disable-DnssecForVerifiedDomain.md b/exchange/exchange-ps/exchange/Disable-DnssecForVerifiedDomain.md
@@ -14,8 +14,6 @@ ms.reviewer:
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
-
 Use the Disable-DnssecForVerifiedDomain cmdlet to disable Domain Name System Security (DNSSEC) for inbound mail to accepted domains in Exchange Online.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
diff --git a/exchange/exchange-ps/exchange/Disable-SmtpDaneInbound.md b/exchange/exchange-ps/exchange/Disable-SmtpDaneInbound.md
@@ -14,8 +14,6 @@ ms.reviewer:
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
-
 Use the Disable-SMTPDaneInbound cmdlet to disable SMTP DNS-based Authentication of Named Entities (DANE) for inbound mail to accepted domains in Exchange Online.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
diff --git a/exchange/exchange-ps/exchange/Enable-DnssecForVerifiedDomain.md b/exchange/exchange-ps/exchange/Enable-DnssecForVerifiedDomain.md
@@ -14,8 +14,6 @@ ms.reviewer:
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
-
 Use the Enable-DnssecForVerifiedDomain cmdlet to enable Domain Name System Security (DNSSEC) for inbound mail to accepted domains in Exchange Online.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
diff --git a/exchange/exchange-ps/exchange/Enable-SmtpDaneInbound.md b/exchange/exchange-ps/exchange/Enable-SmtpDaneInbound.md
@@ -14,8 +14,6 @@ ms.reviewer:
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
-
 Use the Enable-SMTPDaneInbound cmdlet to enable SMTP DNS-based Authentication of Named Entities (DANE) for inbound mail to accepted domains in Exchange Online.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
diff --git a/exchange/exchange-ps/exchange/Get-DnssecStatusForVerifiedDomain.md b/exchange/exchange-ps/exchange/Get-DnssecStatusForVerifiedDomain.md
@@ -14,8 +14,6 @@ ms.reviewer:
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
-
 Use the Get-DnssecStatusForVerifiedDomain cmdlet to view information about Domain Name System Security (DNSSEC) for accepted domains in Exchange Online.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
diff --git a/exchange/exchange-ps/exchange/Get-SmtpDaneInboundStatus.md b/exchange/exchange-ps/exchange/Get-SmtpDaneInboundStatus.md
@@ -14,8 +14,6 @@ ms.reviewer:
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-**Note**: This cmdlet and the associated features are currently in Preview, aren't available in all organizations, and are subject to change.
-
 Use the Get-SmtpDaneInboundStatus cmdlet to view information about SMTP DNS-based Authentication of Named Entities (DANE) for inbound mail to accepted domains in Exchange Online.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
diff --git a/exchange/exchange-ps/exchange/New-MailboxRestoreRequest.md b/exchange/exchange-ps/exchange/New-MailboxRestoreRequest.md
@@ -249,6 +249,17 @@ New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smit
 
 In on-premises Exchange, this example restores the content of the source mailbox with the DisplayName of Tony Smith on mailbox database MBD01 to the archive mailbox for Tony@contoso.com.
 
+### Example 3
+```powershell
+New-MailboxRestoreRequest -SourceMailbox 33948c06-c453-48be-bdb9-08eacd466f81 -TargetMailbox Tony@contoso.com -AllowLegacyDNMismatch
+```
+
+In Exchange Online, this example restores the content of the inactive, disconnected, or soft deleted source mailbox to the active mailbox for Tony@contoso.com:
+
+- The SourceMailbox value is the MailboxGUID value of an inactive, disconnected, or soft deleted mailbox.
+- The TargetMailbox value is the MailboxGUID or email address of the active target mailbox.
+- AllowLegacyDNMismatch allows copying data from one mailbox to another in this scenario.
+
 ## PARAMETERS
 
 ### -CrossTenantRestore
diff --git a/exchange/exchange-ps/exchange/New-TransportRule.md b/exchange/exchange-ps/exchange/New-TransportRule.md
@@ -3270,7 +3270,7 @@ This parameter specifies an action or part of an action for the rule.
 
 In on-premises Exchange, this action is available only on Mailbox servers.
 
-The GenerateNotification parameter specifies an action that sends a notification message to recipients. For example, you can use this parameter to notify recipients that a message was rejected by the rule, or marked as spam and delivered to their Junk Email folder.
+The GenerateNotification parameter specifies an action that sends a notification message to recipients that match the conditions of the rule. For example, you can use this parameter to notify recipients that a message was rejected by the rule, or marked as spam and delivered to their Junk Email folder. Each matched recipient receives a separate notification.
 
 This parameter supports plain text, HTML tags and the following keywords that use values from the original message:
 
diff --git a/exchange/exchange-ps/exchange/Set-OwaMailboxPolicy.md b/exchange/exchange-ps/exchange/Set-OwaMailboxPolicy.md
@@ -96,6 +96,7 @@ Set-OwaMailboxPolicy [-Identity] <MailboxPolicyIdParameter>
  [-OrganizationEnabled <Boolean>]
  [-OutboundCharset <OutboundCharsetOptions>]
  [-OutlookBetaToggleEnabled <Boolean>]
+ [-OutlookDataFile <OutlookDataFileFeatureState>]
  [-OutlookNewslettersAccessLevel <OutlookNewslettersAccessLevel>]
  [-OutlookNewslettersReactions <OutlookNewslettersFeatureState>]
  [-OutlookNewslettersShowMore <OutlookNewslettersFeatureState>]
@@ -1759,6 +1760,31 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -OutlookDataFile
+This parameter is available only in the cloud-based service.
+
+The OutlookDataFile paramater specifies what users can do with .pst files in the new Outlook for Windows. Valid values are:
+
+- Allow: The defaul value. Users can open .pst files, import from a .pst file to a mailbox, export from a mailbox to a .pst file, and copy items to and from .pst files.
+- NoExport: Users can't export from a mailbox to a .pst file.
+- NoExportNoGrow: Users can't export from a mailbox to a .pst file, or copy items from a mailbox to a .pst file.
+- NoExportNoOpen: Users can't export from a mailbox to a .pst file, or open new .pst files.
+- NoExportNoOpenNoGrow: Users can't export from a mailbox to a .pst file, copy items from a mailbox to a .pst file, or open new .pst files.
+- Deny: Users can't open new .pst files, import from a .pst file to a mailbox, export from a mailbox to a .pst file, or copy items to and from .pst files.
+
+```yaml
+Type: OutlookDataFileFeatureState
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: Allow
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -OutlookNewslettersReactions
 This parameter is available only in the cloud-based service.
 
diff --git a/exchange/exchange-ps/exchange/Set-TransportRule.md b/exchange/exchange-ps/exchange/Set-TransportRule.md
@@ -3247,7 +3247,7 @@ This parameter specifies an action or part of an action for the rule.
 
 In on-premises Exchange, this action is available only on Mailbox servers.
 
-The GenerateNotification parameter specifies an action that sends a notification message to recipients. For example, you can use this parameter to notify recipients that a message was rejected by the rule, or marked as spam and delivered to their Junk Email folder.
+The GenerateNotification parameter specifies an action that sends a notification message to recipients that match the conditions of the rule. For example, you can use this parameter to notify recipients that a message was rejected by the rule, or marked as spam and delivered to their Junk Email folder. Each matched recipient receives a separate notification.
 
 This parameter supports plain text, HTML tags and the following keywords that use values from the original message:
 
diff --git a/teams/teams-ps/teams/Get-ALLM365TeamsApps.md b/teams/teams-ps/teams/Get-ALLM365TeamsApps.md
@@ -5,7 +5,7 @@ online version: https://docs.microsoft.com/powershell/module/teams/Get-ALLM365Te
 applicable: Microsoft Teams
 title: Get-ALLM365TeamsApps
 author: lkueter
-ms.author: satishtimiri
+ms.author: sribagchi
 manager: rahulrgupta
 ms.date: 04/24/2024
 schema: 2.0.0
@@ -45,6 +45,14 @@ PS C:\> Get-AllM365TeamsApps | Select-Object -Property Id, IsBlocked, AvailableT
 
 Returns a complete list of all Teams apps in an organization, their statuses, and their availability information in expanded format.
 
+### Example 3
+
+```powershell
+PS C:\> Get-AllM365TeamsApps | Select-Object -Property Id, IsBlocked, AvailableTo, InstalledFor -ExpandProperty InstalledFor
+```
+
+Returns a complete list of all Teams apps in an organization, their statuses, their availability and their installation information in expanded format.
+
 ## PARAMETERS
 
 ### CommonParameters
@@ -81,6 +89,20 @@ Properties:
 - LastUpdatedTimestamp: Time and date when the app AvailableTo value was last updated.
 - AssignedBy: UserID of the last user who updated the app available to value.
 
+**InstalledFor**  
+Provides installation status for the app.  
+Properties:
+
+- AppInstallType: App availability type.  
+  Values:
+  - Everyone
+  - UsersandGroups
+  - Noone
+- LastUpdatedTimestamp: Time and date when the app AvailableTo value was last updated.
+- InstalledBy: UserID of the last user who installed the app available to value.
+- InstalledSource: Source of Installation
+- Version: Version of the app installed
+
 ## RELATED LINKS
 
 [Get-M365TeamsApp](Get-M365TeamsApp.md)
diff --git a/teams/teams-ps/teams/Get-M365TeamsApp.md b/teams/teams-ps/teams/Get-M365TeamsApp.md
@@ -5,7 +5,7 @@ online version: https://docs.microsoft.com/powershell/module/teams/Get-M365Teams
 applicable: Microsoft Teams
 title: Get-M365TeamsApp
 author: lkueter
-ms.author: satishtimiri
+ms.author: sribagchi
 manager: rahulrgupta
 schema: 2.0.0
 ---
@@ -96,6 +96,30 @@ Properties:
   - AssignedBy: UserID of last user who updated the app AvailableTo value.
   - LastUpdatedTimeStamp: Time and date when the app AvailableTo value was last updated.
 
+**InstalledFor**  
+Provides installed for properties for the app.  
+Properties:
+
+- AppInstallType: App install type.  
+  Values:
+  - Everyone
+  - UsersandGroups
+  - Noone
+- LastUpdatedTimestamp: Last Updated date
+- InstalledBy: The user performing the installation
+- InstalledSource: Source of installation
+- Version: Version of the app installed
+- InstallForUsers: List of all the users for whom the app is enabled.  
+  Values:
+  - Id: GUID of UserIDs.
+  - AssignedBy: UserID of last user who updated the app AvailableTo value.
+  - LastUpdatedTimeStamp: Time and date when the app AvailableTo value was last updated.
+- InstallForGroups: List of all the groups for whom the app is enabled.  
+  Values:
+  - Id: GUID of GroupIDs.
+  - AssignedBy: UserID of last user who updated the app AvailableTo value.
+  - LastUpdatedTimeStamp: Time and date when the app AvailableTo value was last updated.
+
 ## RELATED LINKS
 
 [Get-AllM365TeamsApps](Get-ALLM365TeamsApps.md)
diff --git a/teams/teams-ps/teams/Get-M365UnifiedTenantSettings.md b/teams/teams-ps/teams/Get-M365UnifiedTenantSettings.md
@@ -0,0 +1,100 @@
+---
+external help file: Microsoft.Teams.PowerShell.TeamsCmdlets.dll-Help.xml
+Module Name: MicrosoftTeams
+online version: https://docs.microsoft.com/powershell/module/teams/Get-M365UnifiedTenantSettings
+applicable: Microsoft Teams
+title: Get-M365UnifiedTenantSettings
+author: lkueter
+ms.author: sribagchi
+manager: rahulrgupta
+ms.date: 10/22/2024
+schema: 2.0.0
+---
+
+# Get-M365UnifiedTenantSettings
+
+## SYNOPSIS
+
+This cmdlet returns the current tenant settings for a particular tenant
+
+## SYNTAX
+
+```powershell
+Get-M365UnifiedTenantSettings -SettingNames <String[]> [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Get-M365UnifiedTenantSettings retrieves the current tenant settings for a particular tenant.
+
+## EXAMPLES
+
+### Example 1
+
+```powershell
+PS C:\> Get-M365UnifiedTenantSettings
+```
+
+Returns all the current tenant settings for this tenant.
+
+### Example 2
+
+```powershell
+PS C:\> Get-M365UnifiedTenantSettings -SettingNames DefaultApp
+```
+
+Returns the current tenant setting for DefaultApp for this tenant.
+
+### Example 3
+
+```powershell
+PS C:\> Get-M365UnifiedTenantSettings -SettingNames DefaultApp,EnableCopilotExtensibility
+```
+
+Returns the current tenant setting for DefaultApp and EnableCopilotExtensibility for this tenant.
+
+## PARAMETERS
+
+### -SettingNames
+
+Setting names requested. Possible values - DefaultApp,GlobalApp,PrivateApp,EnableCopilotExtensibility
+
+```yaml
+Type: String
+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](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+
+**SettingName**  
+Setting Name returned.
+
+**SettingValue**  
+The status of this setting in the tenant.  
+Values:
+
+- All
+- None
+- Some (only applicable for EnableCopilotExtensibility)
+
+**Users**  
+The list of users this setting is applicable to (only applicable for EnableCopilotExtensibility).  
+
+**Groups**  
+The list of groups this setting is applicable to (only applicable for EnableCopilotExtensibility).  
diff --git a/teams/teams-ps/teams/New-CsAutoAttendant.md b/teams/teams-ps/teams/New-CsAutoAttendant.md
@@ -18,7 +18,7 @@ Use the New-CsAutoAttendant cmdlet to create a new Auto Attendant (AA).
 ## SYNTAX
 
 ```powershell
-New-CsAutoAttendant -Name <String> -LanguageId <String> -TimeZoneId <String> -DefaultCallFlow <Object> [-CallFlows <Object>] [-CallHandlingAssociations <Object>] [-Operator <Object>] [-VoiceId <String>] [-EnableVoiceResponse] [-InclusionScope <Object>] [-ExclusionScope <Object>] [-AuthorizedUsers <List>] [-HideAuthorizedUsers <List>] [-Tenant <Guid>] [<CommonParameters>]
+New-CsAutoAttendant -Name <String> -LanguageId <String> -TimeZoneId <String> -DefaultCallFlow <Object> [-CallFlows <Object>] [-CallHandlingAssociations <Object>] [-Operator <Object>] [-VoiceId <String>] [-EnableVoiceResponse] [-InclusionScope <Object>] [-ExclusionScope <Object>] [-AuthorizedUsers <List>] [-HideAuthorizedUsers <List>] [-UserNameExtension <String>] [-Tenant <Guid>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -505,6 +505,27 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -UserNameExtension
+
+The UserNameExtension parameter is a string that specifies how to extend usernames in dial search by appending additional information after the name.
+This parameter is used in dial search when multiple search results are found, as it helps to distinguish users with similar names. Possible values are:
+
+- None: Default value, which means the username is pronounced as is.
+- Office: Adds office information from the user profile.
+- Department: Adds department information from the user profile.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+applicable: Microsoft Teams
+Required: false
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Tenant
 
 ```yaml
diff --git a/teams/teams-ps/teams/New-CsAutoAttendantCallableEntity.md b/teams/teams-ps/teams/New-CsAutoAttendantCallableEntity.md
@@ -18,14 +18,15 @@ The New-CsAutoAttendantCallableEntity cmdlet lets you create a callable entity.
 ## SYNTAX
 
 ```powershell
-New-CsAutoAttendantCallableEntity -Identity <String> -Type <User | ApplicationEndpoint | ExternalPstn | SharedVoicemail> [-Tenant <Guid>] [-EnableTranscription] [-EnableSharedVoicemailSystemPromptSuppression] [-CallPriority <Int16>] [<CommonParameters>]
+New-CsAutoAttendantCallableEntity -Identity <String> -Type <User | ApplicationEndpoint | ConfigurationEndpoint | ExternalPstn | SharedVoicemail> [-Tenant <Guid>] [-EnableTranscription] [-EnableSharedVoicemailSystemPromptSuppression] [-CallPriority <Int16>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 The New-CsAutoAttendantCallableEntity cmdlet lets you create a callable entity for use with call transfers from the Auto Attendant service. Callable entities can be created using either Object ID or TEL URIs and can refer to any of the following entities:
 
 - User
 - ApplicationEndpoint
+- ConfigurationEndpoint
 - ExternalPstn
 - SharedVoicemail
 
@@ -96,7 +97,8 @@ Accept wildcard characters: False
 The Type parameter represents the type of the callable entity, which can be any of the following:
 
 - User
-- ApplicationEndpoint
+- ApplicationEndpoint (when transferring to a Resource Account)
+- ConfigurationEndpoint (when transferring directly to a nested Auto Attendant or Call Queue)
 - ExternalPstn
 - SharedVoicemail
 
diff --git a/teams/teams-ps/teams/New-CsCallQueue.md b/teams/teams-ps/teams/New-CsCallQueue.md
@@ -1490,7 +1490,6 @@ Accept wildcard characters: False
 
 ### -ServiceLevelThresholdResponseTimeInSecond
 _Private Preview customers only_
-_Saving a call queue configuration through Teams admin center will *remove* this setting._
 
 The target number of seconds calls should be answered in. This number is used to calculate the call queue service level percentage.
 
diff --git a/teams/teams-ps/teams/Set-CsCallQueue.md b/teams/teams-ps/teams/Set-CsCallQueue.md
diff --git a/teams/teams-ps/teams/Update-M365TeamsApp.md b/teams/teams-ps/teams/Update-M365TeamsApp.md
diff --git a/teams/teams-ps/teams/Update-M365UnifiedTenantSettings.md b/teams/teams-ps/teams/Update-M365UnifiedTenantSettings.md
