Merge pull request #12331 from MicrosoftDocs/main

publish main to live, 3:30 pm, 10/28/24

Author: rjagiewich

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).  

teams/teams-ps/teams/Update-M365TeamsApp.md

@@ -5,7 +5,7 @@ online version: https://docs.microsoft.com/powershell/module/teams/Update-M365Te
 applicable: Microsoft Teams
 title: Update-M365TeamsApp
 author: lkueter
-ms.author: satishtimiri
+ms.author: sribagchi
 manager: rahulrgupta
 ms.date: 04/24/2024
 schema: 2.0.0
@@ -21,12 +21,12 @@ This cmdlet updates app state and app available values for the Microsoft Teams a
 
 ```powershell
 Update-M365TeamsApp -Id <String> [-IsBlocked <Boolean>] -AppAssignmentType <String> -OperationType <String>
- [-Users <String[]>] [-Groups <String[]>] [<CommonParameters>]
+ [-Users <String[]>] [-Groups <String[]>] -AppInstallType <String> -InstallForOperationType <String> [-InstallForUsers <String[]> -InstallForGroups <String[]> -InstallVersion <String>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 
-This cmdlet allows administrators to modify app state and availability by adding or removing users and groups or changing assignment type.
+This cmdlet allows administrators to modify app state, availability and installation status by adding or removing users and groups or changing assignment type or installation status.
 
 ## EXAMPLES
 
@@ -51,6 +51,13 @@ PS C:\> Update-M365TeamsApp -Id 4c4ec2e8-4a2c-4bce-8d8f-00fc664a4e5b -IsBlocked
 ```
 Unblocks Bookings app (App ID 4c4ec2e8-4a2c-4bce-8d8f-00fc664a4e5b).
 
+### Example 4
+
+```powershell
+PS C:\> Update-M365TeamsApp -Id 2b876f4d-2e6b-4ee7-9b09-8893808c1380 -IsBlocked $false -AppInstallType UsersAndGroups -InstallForOperationType Add -InstallForUsers 77f5d400-a12e-4168-8e63-ccd2243d33a8,f2f4d8bc-1fb3-4292-867e-6d19efb0eb7c,37b6fc6a-32a4-4767-ac2e-c2f2307bad5c -InstallForGroups 926d57ad-431c-4e6a-9e16-347eacc91aa4 -InstallVersion 4.1.2
+```
+Unblocks 1Page App (App ID 2b876f4d-2e6b-4ee7-9b09-8893808c1380) and updates installation setting for the app to include 3 users and 1 group.
+
 
 ## PARAMETERS
 
@@ -150,6 +157,87 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -AppInstallType
+
+App installation type.
+
+```yaml
+Type: String
+Parameter Sets: (Everyone, UsersandGroups, Noone)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -InstallForOperationType
+
+Operation performed on the app installation.
+
+```yaml
+Type: String
+Parameter Sets: (Add, Remove)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -InstallForUsers
+
+List of all the users for whom the app is installed.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+
+### -InstallForGroups
+
+List of all the groups for whom the app is installed.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -InstallVersion
+
+App version to be installed.
+
+```yaml
+Type: String
+Aliases:
+
+Required: True
+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).

teams/teams-ps/teams/Update-M365UnifiedTenantSettings.md

@@ -0,0 +1,138 @@
+---
+external help file: Microsoft.Teams.PowerShell.TeamsCmdlets.dll-Help.xml
+Module Name: MicrosoftTeams
+online version: https://docs.microsoft.com/powershell/module/teams/Update-M365UnifiedTenantSettings
+applicable: Microsoft Teams
+title: Update-M365UnifiedTenantSettings
+author: lkueter
+ms.author: sribagchi
+manager: rahulrgupta
+ms.date: 10/22/2024
+schema: 2.0.0
+---
+
+# Update-M365UnifiedTenantSettings
+
+## SYNOPSIS
+
+This cmdlet updates tenant settings.
+
+## SYNTAX
+
+```powershell
+Update-M365UnifiedTenantSettings -SettingName <String> -SettingValue <String> [-Users <String[]>] [-Groups <String[]>] [-Operation <String>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+This cmdlet allows administrators to modify tenant settings.
+
+## EXAMPLES
+
+### Example 1
+
+```powershell
+PS C:\> PS C:\> Update-M365UnifiedTenantSettings -SettingName EnableCopilotExtensibility -SettingValue Some -Users d156010d-fb18-497f-804c-155ec2aa06d3,a62fba7e-e362-493c-a094-fdec17e2fee8 -Groups 37da2d58-fc14-453e-9a14-5065ebd63a1d, 37da2d58-fc14-453e-9a14-5065ebd63a1e -Operation add
+```
+Updates the tenant setting for EnableCopilotExtensibility to 2 users and 2 groups.
+
+### Example 2
+
+```powershell
+PS C:\> Update-M365UnifiedTenantSettings -SettingName GlobalApp -SettingValue None
+```
+Updates the tenant setting for GlobalApp to None
+
+
+## PARAMETERS
+
+### -SettingName
+
+Setting Name to be changed.
+
+```yaml
+Type: String
+Parameter Sets: (DefaultApp, GlobalApp, PrivateApp, EnableCopilotExtensibility)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SettingValue
+Setting Value to be changed.
+
+```yaml
+Type: String
+Parameter Sets: (All, None, Some)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Operation
+
+Operation performed (whether we are adding or removing users/groups).
+
+```yaml
+Type: String
+Parameter Sets: (add, remove)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Users
+
+List of all the users for whom the app is enabled or disabled.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Groups
+
+List of all the groups for whom the app is enabled or disabled.
+
+```yaml
+Type: String[]
+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](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object