From dec58c0794b78e2f90720ebdef1a1c5add081fb2 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 08:53:03 -0700 Subject: [PATCH 01/26] Update New-CsCallQueue.md --- teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md b/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md index d5edf96b3a..662d585a39 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md @@ -14,7 +14,9 @@ title: New-CsCallQueue # New-CsCallQueue ## SYNOPSIS -Creates new Call Queue in your Skype for Business Online organization. +Creates new Call Queue in your Teams organization. + +Line to start changes. ## SYNTAX From 74c170a9fac3944e2987f95ac7b9ed39fdafbd72 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 08:54:41 -0700 Subject: [PATCH 02/26] Create Set-CsPersonalAttendantSettings.md --- .../Set-CsPersonalAttendantSettings.md | 334 ++++++++++++++++++ 1 file changed, 334 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md new file mode 100644 index 0000000000..7d85cffd03 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md @@ -0,0 +1,334 @@ +--- +applicable: Microsoft Teams +author: juliiva +external help file: Microsoft.Rtc.Management.dll-Help.xml +Locale: en-US +manager: jomarque +Module Name: MicrosoftTeams +ms.author: juliiva +online version: https://learn.microsoft.com/powershell/module/microsoftteams/set-cspersonalattendantsettings +schema: 2.0.0 +title: Set-CsPersonalAttendantSettings +--- + +# Set-CsPersonalAttendantSettings + +## SYNOPSIS + +**Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. + +This cmdlet will set personal attendant settings for the specified user. + +## SYNTAX + +``` +Set-CsPersonalAttendantSettings -Identity -IsPersonalAttendantEnabled -DefaultLanguage [-DefaultVoice ] [-CalleeName ] [-DefaultTone ] -IsBookingCalendarEnabled [-IsNonContactCallbackEnabled ] -IsCallScreeningEnabled -AllowInboundInternalCalls -AllowInboundFederatedCalls -AllowInboundPSTNCalls -IsAutomaticTranscriptionEnabled -IsAutomaticRecordingEnabled [] +``` + +## DESCRIPTION + +This cmdlet sets personal attendant settings for the specified user. + +When specifying settings you need to specify all settings, for instance, you can't just turn call screening on. Instead, you need to +start by getting the current settings, making the necessary changes, and then setting/writing all settings. + +## EXAMPLES + +### Example 1 +``` +Set-CsPersonalAttendantSettings -Identity user1@contoso.com -IsPersonalAttendantEnabled $true -DefaultLanguage en-US -CalleeName User1 -IsBookingCalendarEnabled $false -IsCallScreeningEnabled $false +-AllowInboundInternalCalls $true -AllowInboundFederatedCalls $false -AllowInboundPSTNCalls $false -IsAutomaticTranscriptionEnabled $false -IsAutomaticRecordingEnabled $false +``` + +This example shows setting up personal attendant for user1@contoso.com. Personal attendant communicates in English. Personal attendant will refer to its owner as User1. +Personal attendant is only enabled for inbound Teams calls from the user's domain. Additional capabilities are turned off. + +### Example 2 +``` +Set-CsPersonalAttendantSettings -Identity user1@contoso.com -IsPersonalAttendantEnabled $true -DefaultLanguage en-US -CalleeName User1 -IsBookingCalendarEnabled $true -IsCallScreeningEnabled $false +-AllowInboundInternalCalls $true -AllowInboundFederatedCalls $false -AllowInboundPSTNCalls $false -IsAutomaticTranscriptionEnabled $false -IsAutomaticRecordingEnabled $false +``` + +This example shows setting up personal attendant for user1@contoso.com. In addition to previously mentioned capabilities, personal attendant is able to access personal bookings calendar, +fetch the user's availability and schedule callbacks on behalf of the user. Calendar operations are enabled for all incoming callers. user1 must specify the bookings link in Teams Personal Attendant settings. + +### Example 3 +``` +Set-CsPersonalAttendantSettings -Identity user1@contoso.com -IsPersonalAttendantEnabled $true -DefaultLanguage en-US -CalleeName User1 -IsBookingCalendarEnabled $true -IsCallScreeningEnabled $false +-AllowInboundInternalCalls $true -AllowInboundFederatedCalls $true -AllowInboundPSTNCalls $true -IsAutomaticTranscriptionEnabled $false -IsAutomaticRecordingEnabled $false +``` + +This example shows setting up personal attendant for user1@contoso.com. In addition to previously mentioned capabilities, personal attendant is enabled for all incoming calls: the user's domain, other domains and PSTN. + +### Example 4 +``` +Set-CsPersonalAttendantSettings -Identity user1@contoso.com -IsPersonalAttendantEnabled $true -DefaultLanguage en-US -CalleeName User1 -IsBookingCalendarEnabled $true -IsCallScreeningEnabled $true +-AllowInboundInternalCalls $true -AllowInboundFederatedCalls $true -AllowInboundPSTNCalls $true -IsAutomaticTranscriptionEnabled $false -IsAutomaticRecordingEnabled $false +``` + +This example shows setting up personal attendant for user1@contoso.com. In addition to previously mentioned capabilities, personal attendant is enabled to evaluate the call's context and pass the info to the user. + +### Example 5 +``` +Set-CsPersonalAttendantSettings -Identity user1@contoso.com -IsPersonalAttendantEnabled $true -DefaultLanguage en-US -CalleeName User1 -IsBookingCalendarEnabled $true -IsCallScreeningEnabled $true +-AllowInboundInternalCalls $true -AllowInboundFederatedCalls $true -AllowInboundPSTNCalls $true -IsAutomaticTranscriptionEnabled $true -IsAutomaticRecordingEnabled $true +``` + +This example shows setting up personal attendant for user1@contoso.com. In addition to previously mentioned capabilities, personal attendant is automatically storing call transcription and recording. + +### Example 6 +``` +Set-CsPersonalAttendantSettings -Identity user1@contoso.com -IsPersonalAttendantEnabled $false +``` + +This example shows turning off personal attendant for user1@contoso.com. + +### Example 7 +``` +Set-CsUserCallingSettings -Identity user1@contoso.com -IsForwardingEnabled $false +Set-CsPersonalAttendantSettings -Identity user1@contoso.com -IsPersonalAttendantEnabled $true -DefaultLanguage en-US -CalleeName User1 -IsBookingCalendarEnabled $false -IsCallScreeningEnabled $false +-AllowInboundInternalCalls $true -AllowInboundFederatedCalls $false -AllowInboundPSTNCalls $false -IsAutomaticTranscriptionEnabled $false -IsAutomaticRecordingEnabled $false +``` + +This example shows how to set up personal attendant for a user, who has call forwarding enabled. + +### Example 8 +``` +Set-CsUserCallingSettings -Identity user1@contoso.com -IsUnansweredEnabled $true -UnansweredTargetType Voicemail -UnansweredDelay 00:00:20 +Set-CsPersonalAttendantSettings -Identity user1@contoso.com -IsPersonalAttendantEnabled $true -DefaultLanguage en-US -CalleeName User1 -IsBookingCalendarEnabled $false -IsCallScreeningEnabled $false +-AllowInboundInternalCalls $true -AllowInboundFederatedCalls $false -AllowInboundPSTNCalls $false -IsAutomaticTranscriptionEnabled $false -IsAutomaticRecordingEnabled $false +``` + +This example shows how to set up personal attendant for a user, who would like to use unanswered call functionality simultaniously with personal attendant. + +## PARAMETERS + +### -Identity +The Identity of the user to set personal attendant settings for. Can be specified using the ObjectId or the SIP address. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: True +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IsPersonalAttendantEnabled +This parameter controls whether personal attendant is enabled or not. If personal attendant is enabled, then at least one of: AllowInboundInternalCalls, AllowInboundFederatedCalls, AllowInboundPSTNCalls must be enabled. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant,PersonalAttendantOnOff) +Aliases: + +Required: True +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DefaultLanguage +Language to be used by personal attendant in communication. The preliminary list of supported languages is: +en-US, fr-FR, ar-SA, zh-CN, zh-TW, cs-CZ, da-DK, nl-NL, en-AU, en-GB, fi-FI, fr-CA, de-DE, el-GR, hi-IN, id-ID, it-IT, ja-JP, ko-KR, nb-NO, pl-PL, pt-BR, ru-RU, es-ES, es-US, sv-SE, th-TH, tr-TR + +```yaml +Type: System.String +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: True +Default value: en-US +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DefaultVoice +Voice to be used by personal attendant in communication. Supported values are Female and Male. + +> [!NOTE] +> This parameter is currently in development and changing it does not change the behavior of Personal Attendant. + +```yaml +Type: System.String +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: False +Default value: Female +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CalleeName +Name that personal attendant uses when referring to its owner. + +```yaml +Type: System.String +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: False +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -DefaultTone +Tone to be used by personal attendant in communication. Supported values are Formal and Casual. + +> [!NOTE] +> This parameter is currently in development and enabling/disabling it does not change the behavior of Personal Attendant. + +```yaml +Type: System.String +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: False +Default value: Formal +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IsBookingCalendarEnabled +This parameter controls whether personal attendant can access personal bookings calendar to fetch the user's availability and schedule callbacks on behalf of the user. +If access to personal calendar is enabled by admin, user must specify the bookings link in Teams Personal Attendant settings. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: True +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IsNonContactCallbackEnabled +This parameter controls whether personal attendant calendar operations for callers not in the user contact list are enabled or not. + +> [!NOTE] +> This parameter is currently in development and enabling/disabling it does not change the behavior of Personal Attendant. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: False +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IsCallScreeningEnabled +This parameter controls whether personal attendant evaluates calls context and passes the info to the user. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: True +Default value: True +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AllowInboundInternalCalls +This parameter controls whether personal attendant for incoming domain calls is enabled or not. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: True +Default value: True +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AllowInboundFederatedCalls +This parameter controls whether personal attendant for incoming calls from other domains is enabled or not. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: True +Default value: True +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AllowInboundPSTNCalls +This parameter controls whether personal attendant for incoming PSTN calls is enabled or not. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: True +Default value: True +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IsAutomaticTranscriptionEnabled +This parameter controls whether automatic storing of transcriptions (of personal attendant calls) is enabled or not. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: True +Default value: True +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IsAutomaticRecordingEnabled +This parameter controls whether automatic storing of recordings (of personal attendant calls) is enabled or not. + +```yaml +Type: System.Boolean +Parameter Sets: (PersonalAttendant) +Aliases: + +Required: True +Default value: True +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES +The cmdlet is available in Teams PowerShell module 7.3.0 or later. + +The specified user need to have the Microsoft Phone System license assigned. + +The cmdlet is validating different settings and is always writing all the parameters. You might see validation errors from the cmdlet due to +this behavior. As an example, if you already have call forwarding set up and you want to set up personal attendant, you will get a validation error. + + +## RELATED LINKS +[Get-CsPersonalAttendantSettings](./get-cspersonalattendantsettings.md) From 41405d1658954ff0da362c06afe205adef1153c6 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 08:58:32 -0700 Subject: [PATCH 03/26] Update New-CsCallQueue.md --- teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md b/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md index 662d585a39..e970422246 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md @@ -16,8 +16,6 @@ title: New-CsCallQueue ## SYNOPSIS Creates new Call Queue in your Teams organization. -Line to start changes. - ## SYNTAX ``` From 9eba564c2cc3af05a247227e3a63f08940f7d917 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:01:06 -0700 Subject: [PATCH 04/26] Create Get-CsPersonalAttendantSettings.md --- .../Get-CsPersonalAttendantSettings.md | 201 ++++++++++++++++++ 1 file changed, 201 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md new file mode 100644 index 0000000000..e7a446e77b --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -0,0 +1,201 @@ +--- +applicable: Microsoft Teams +author: juliiva +external help file: Microsoft.Rtc.Management.dll-Help.xml +Locale: en-US +manager: jomarque +Module Name: MicrosoftTeams +ms.author: juliiva +online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-cspersonalattendantsettings +schema: 2.0.0 +title: Get-CsPersonalAttendantSettings +--- + +# Get-CsPersonalAttendantSettings + +## SYNOPSIS + +**Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. + +This cmdlet will show personal attendant settings for a user. + +## SYNTAX + +``` +Get-CsPersonalAttendantSettings -Identity [] + +``` + +## DESCRIPTION + +This cmdlet shows the personal attendant settings for a user. + +## EXAMPLES + +### Example 1 +``` +Get-CsPersonalAttendantSettings -Identity user1@contoso.com +``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : False +IsNonContactCallbackEnabled : False +IsCallScreeningEnabled : False +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : False +AllowInboundPSTNCalls : False +IsAutomaticTranscriptionEnabled : False +IsAutomaticRecordingEnabled : False +``` + +This example shows that user1@contoso.com has personal attendant enabled (personal attendant communicates in English). Personal attendant will refer to its owner as User1. +Personal attendant is only enabled for inbound Teams calls from the user's domain. Additional capabilities are turned off. + +### Example 2 +``` +Get-CsPersonalAttendantSettings -Identity user1@contoso.com +``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : True +IsNonContactCallbackEnabled : False +IsCallScreeningEnabled : False +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : False +AllowInboundPSTNCalls : False +IsAutomaticTranscriptionEnabled : False +IsAutomaticRecordingEnabled : False +``` + +This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is able to access personal bookings calendar, +fetch the user's availability and schedule callbacks on behalf of the user. Calendar operations are enabled for all incoming callers. user1 must specify the bookings link in Teams Personal Attendant settings. + +### Example 3 +``` +Get-CsPersonalAttendantSettings -Identity user1@contoso.com +``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : True +IsNonContactCallbackEnabled : True +IsCallScreeningEnabled : False +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : True +AllowInboundPSTNCalls : True +IsAutomaticTranscriptionEnabled : False +IsAutomaticRecordingEnabled : False +``` + +This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is enabled for all incoming calls: the user's domain, other domains and PSTN. + +### Example 4 +``` +Get-CsPersonalAttendantSettings -Identity user1@contoso.com +``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : True +IsNonContactCallbackEnabled : True +IsCallScreeningEnabled : True +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : True +AllowInboundPSTNCalls : True +IsAutomaticTranscriptionEnabled : False +IsAutomaticRecordingEnabled : False +``` + +This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is enabled to evaluate the call's context and pass the info to the user. + +### Example 5 +``` +Get-CsPersonalAttendantSettings -Identity user1@contoso.com +``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : True +IsNonContactCallbackEnabled : True +IsCallScreeningEnabled : True +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : True +AllowInboundPSTNCalls : True +IsAutomaticTranscriptionEnabled : True +IsAutomaticRecordingEnabled : True +``` + +This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is automatically storing call transcription and recording. + +### Example 6 +``` +Get-CsPersonalAttendantSettings -Identity user11@contoso.com +``` +```output +IsPersonalAttendantEnabled : False +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : +DefaultTone : Formal +IsBookingCalendarEnabled : False +IsNonContactCallbackEnabled : False +IsCallScreeningEnabled : True +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : True +AllowInboundPSTNCalls : True +IsAutomaticTranscriptionEnabled : True +IsAutomaticRecordingEnabled : True +``` + +This example shows the default settings for the user that has never changed the personal attendant settings via Microsoft Teams. + +## PARAMETERS + +### -Identity +The Identity of the user to show personal attendant settings for. Can be specified using the ObjectId or the SIP address. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: True +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES +The cmdlet is available in Teams PowerShell module 7.3.0 or later. + +## RELATED LINKS + +[Set-CsPersonalAttendantSettings](./set-cspersonalattendantsettings.md) From 5bb61064611430afacf98c0224d8a01d23f56e48 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:04:07 -0700 Subject: [PATCH 05/26] Update Set-CsPersonalAttendantSettings.md --- .../Set-CsPersonalAttendantSettings.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md index 7d85cffd03..3c45a93930 100644 --- a/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md @@ -122,7 +122,7 @@ This parameter controls whether personal attendant is enabled or not. If persona ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant,PersonalAttendantOnOff) +Parameter Sets: (All) Aliases: Required: True @@ -137,7 +137,7 @@ en-US, fr-FR, ar-SA, zh-CN, zh-TW, cs-CZ, da-DK, nl-NL, en-AU, en-GB, fi-FI, fr- ```yaml Type: System.String -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: True @@ -154,7 +154,7 @@ Voice to be used by personal attendant in communication. Supported values are Fe ```yaml Type: System.String -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: False @@ -168,7 +168,7 @@ Name that personal attendant uses when referring to its owner. ```yaml Type: System.String -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: False @@ -185,7 +185,7 @@ Tone to be used by personal attendant in communication. Supported values are For ```yaml Type: System.String -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: False @@ -200,7 +200,7 @@ If access to personal calendar is enabled by admin, user must specify the bookin ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: True @@ -217,7 +217,7 @@ This parameter controls whether personal attendant calendar operations for calle ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: False @@ -231,7 +231,7 @@ This parameter controls whether personal attendant evaluates calls context and p ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: True @@ -245,7 +245,7 @@ This parameter controls whether personal attendant for incoming domain calls is ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: True @@ -259,7 +259,7 @@ This parameter controls whether personal attendant for incoming calls from other ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: True @@ -273,7 +273,7 @@ This parameter controls whether personal attendant for incoming PSTN calls is en ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: True @@ -287,7 +287,7 @@ This parameter controls whether automatic storing of transcriptions (of personal ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: True @@ -301,7 +301,7 @@ This parameter controls whether automatic storing of recordings (of personal att ```yaml Type: System.Boolean -Parameter Sets: (PersonalAttendant) +Parameter Sets: (All) Aliases: Required: True From b44ac70deed00e037411179c4e3b77b4ea8a8380 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:07:27 -0700 Subject: [PATCH 06/26] Update Get-CsPersonalAttendantSettings.md --- teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md | 1 - 1 file changed, 1 deletion(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md index e7a446e77b..732fec719f 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -23,7 +23,6 @@ This cmdlet will show personal attendant settings for a user. ``` Get-CsPersonalAttendantSettings -Identity [] - ``` ## DESCRIPTION From 4c5ae75e36360d42a45d62fb8820696388943684 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:09:08 -0700 Subject: [PATCH 07/26] Update Get-CsPersonalAttendantSettings.md --- .../Get-CsPersonalAttendantSettings.md | 30 ------------------- 1 file changed, 30 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md index 732fec719f..a8f4f1147c 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -125,21 +125,6 @@ This example shows that user1@contoso.com has personal attendant enabled. In add ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` -```output -IsPersonalAttendantEnabled : True -DefaultLanguage : en-US -DefaultVoice : Female -CalleeName : User1 -DefaultTone : Formal -IsBookingCalendarEnabled : True -IsNonContactCallbackEnabled : True -IsCallScreeningEnabled : True -AllowInboundInternalCalls : True -AllowInboundFederatedCalls : True -AllowInboundPSTNCalls : True -IsAutomaticTranscriptionEnabled : True -IsAutomaticRecordingEnabled : True -``` This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is automatically storing call transcription and recording. @@ -147,21 +132,6 @@ This example shows that user1@contoso.com has personal attendant enabled. In add ``` Get-CsPersonalAttendantSettings -Identity user11@contoso.com ``` -```output -IsPersonalAttendantEnabled : False -DefaultLanguage : en-US -DefaultVoice : Female -CalleeName : -DefaultTone : Formal -IsBookingCalendarEnabled : False -IsNonContactCallbackEnabled : False -IsCallScreeningEnabled : True -AllowInboundInternalCalls : True -AllowInboundFederatedCalls : True -AllowInboundPSTNCalls : True -IsAutomaticTranscriptionEnabled : True -IsAutomaticRecordingEnabled : True -``` This example shows the default settings for the user that has never changed the personal attendant settings via Microsoft Teams. From 715878a07bff000b3752802e97c1c62d6d309a52 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:15:55 -0700 Subject: [PATCH 08/26] Update Get-CsPersonalAttendantSettings.md --- .../Get-CsPersonalAttendantSettings.md | 60 ------------------- 1 file changed, 60 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md index a8f4f1147c..ca795dc70d 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -35,21 +35,6 @@ This cmdlet shows the personal attendant settings for a user. ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` -```output -IsPersonalAttendantEnabled : True -DefaultLanguage : en-US -DefaultVoice : Female -CalleeName : User1 -DefaultTone : Formal -IsBookingCalendarEnabled : False -IsNonContactCallbackEnabled : False -IsCallScreeningEnabled : False -AllowInboundInternalCalls : True -AllowInboundFederatedCalls : False -AllowInboundPSTNCalls : False -IsAutomaticTranscriptionEnabled : False -IsAutomaticRecordingEnabled : False -``` This example shows that user1@contoso.com has personal attendant enabled (personal attendant communicates in English). Personal attendant will refer to its owner as User1. Personal attendant is only enabled for inbound Teams calls from the user's domain. Additional capabilities are turned off. @@ -58,21 +43,6 @@ Personal attendant is only enabled for inbound Teams calls from the user's domai ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` -```output -IsPersonalAttendantEnabled : True -DefaultLanguage : en-US -DefaultVoice : Female -CalleeName : User1 -DefaultTone : Formal -IsBookingCalendarEnabled : True -IsNonContactCallbackEnabled : False -IsCallScreeningEnabled : False -AllowInboundInternalCalls : True -AllowInboundFederatedCalls : False -AllowInboundPSTNCalls : False -IsAutomaticTranscriptionEnabled : False -IsAutomaticRecordingEnabled : False -``` This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is able to access personal bookings calendar, fetch the user's availability and schedule callbacks on behalf of the user. Calendar operations are enabled for all incoming callers. user1 must specify the bookings link in Teams Personal Attendant settings. @@ -81,21 +51,6 @@ fetch the user's availability and schedule callbacks on behalf of the user. Cale ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` -```output -IsPersonalAttendantEnabled : True -DefaultLanguage : en-US -DefaultVoice : Female -CalleeName : User1 -DefaultTone : Formal -IsBookingCalendarEnabled : True -IsNonContactCallbackEnabled : True -IsCallScreeningEnabled : False -AllowInboundInternalCalls : True -AllowInboundFederatedCalls : True -AllowInboundPSTNCalls : True -IsAutomaticTranscriptionEnabled : False -IsAutomaticRecordingEnabled : False -``` This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is enabled for all incoming calls: the user's domain, other domains and PSTN. @@ -103,21 +58,6 @@ This example shows that user1@contoso.com has personal attendant enabled. In add ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` -```output -IsPersonalAttendantEnabled : True -DefaultLanguage : en-US -DefaultVoice : Female -CalleeName : User1 -DefaultTone : Formal -IsBookingCalendarEnabled : True -IsNonContactCallbackEnabled : True -IsCallScreeningEnabled : True -AllowInboundInternalCalls : True -AllowInboundFederatedCalls : True -AllowInboundPSTNCalls : True -IsAutomaticTranscriptionEnabled : False -IsAutomaticRecordingEnabled : False -``` This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is enabled to evaluate the call's context and pass the info to the user. From 8ff04ea57b1ba77da75a3fb3449bf15090075f7b Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:19:34 -0700 Subject: [PATCH 09/26] Update Get-CsPersonalAttendantSettings.md --- teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md | 1 + 1 file changed, 1 insertion(+) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md index ca795dc70d..c74a4875e7 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -86,6 +86,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False From 62bc5dd69ca79faf003a3bfae7c153935ebb326d Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:21:05 -0700 Subject: [PATCH 10/26] Update Set-CsPersonalAttendantSettings.md --- .../Set-CsPersonalAttendantSettings.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md index 3c45a93930..a9a9293b23 100644 --- a/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Set-CsPersonalAttendantSettings.md @@ -112,6 +112,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False @@ -126,6 +127,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: False Accept pipeline input: False Accept wildcard characters: False @@ -141,6 +143,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: en-US Accept pipeline input: False Accept wildcard characters: False @@ -158,6 +161,7 @@ Parameter Sets: (All) Aliases: Required: False +Position: Named Default value: Female Accept pipeline input: False Accept wildcard characters: False @@ -172,6 +176,7 @@ Parameter Sets: (All) Aliases: Required: False +Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False @@ -189,6 +194,7 @@ Parameter Sets: (All) Aliases: Required: False +Position: Named Default value: Formal Accept pipeline input: False Accept wildcard characters: False @@ -204,6 +210,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: False Accept pipeline input: False Accept wildcard characters: False @@ -221,6 +228,7 @@ Parameter Sets: (All) Aliases: Required: False +Position: Named Default value: False Accept pipeline input: False Accept wildcard characters: False @@ -235,6 +243,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: True Accept pipeline input: False Accept wildcard characters: False @@ -249,6 +258,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: True Accept pipeline input: False Accept wildcard characters: False @@ -263,6 +273,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: True Accept pipeline input: False Accept wildcard characters: False @@ -277,6 +288,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: True Accept pipeline input: False Accept wildcard characters: False @@ -291,6 +303,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: True Accept pipeline input: False Accept wildcard characters: False @@ -305,6 +318,7 @@ Parameter Sets: (All) Aliases: Required: True +Position: Named Default value: True Accept pipeline input: False Accept wildcard characters: False From 5f09e4ebe04929a957c0668a38103afe02ff3249 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:22:49 -0700 Subject: [PATCH 11/26] Update Get-CsPersonalAttendantSettings.md --- .../Get-CsPersonalAttendantSettings.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md index c74a4875e7..4b6f375a58 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -35,6 +35,21 @@ This cmdlet shows the personal attendant settings for a user. ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : False +IsNonContactCallbackEnabled : False +IsCallScreeningEnabled : False +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : False +AllowInboundPSTNCalls : False +IsAutomaticTranscriptionEnabled : False +IsAutomaticRecordingEnabled : False +``` This example shows that user1@contoso.com has personal attendant enabled (personal attendant communicates in English). Personal attendant will refer to its owner as User1. Personal attendant is only enabled for inbound Teams calls from the user's domain. Additional capabilities are turned off. From 453f1bb45e33cb5769fc2f1ab575cedaf8f6bae7 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 09:32:28 -0700 Subject: [PATCH 12/26] Update Get-CsPersonalAttendantSettings.md --- .../Get-CsPersonalAttendantSettings.md | 75 +++++++++++++++++++ 1 file changed, 75 insertions(+) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md index 4b6f375a58..bd61deb0f6 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -58,6 +58,21 @@ Personal attendant is only enabled for inbound Teams calls from the user's domai ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : True +IsNonContactCallbackEnabled : False +IsCallScreeningEnabled : False +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : False +AllowInboundPSTNCalls : False +IsAutomaticTranscriptionEnabled : False +IsAutomaticRecordingEnabled : False +``` This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is able to access personal bookings calendar, fetch the user's availability and schedule callbacks on behalf of the user. Calendar operations are enabled for all incoming callers. user1 must specify the bookings link in Teams Personal Attendant settings. @@ -66,6 +81,21 @@ fetch the user's availability and schedule callbacks on behalf of the user. Cale ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : True +IsNonContactCallbackEnabled : True +IsCallScreeningEnabled : False +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : True +AllowInboundPSTNCalls : True +IsAutomaticTranscriptionEnabled : False +IsAutomaticRecordingEnabled : False +``` This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is enabled for all incoming calls: the user's domain, other domains and PSTN. @@ -73,6 +103,21 @@ This example shows that user1@contoso.com has personal attendant enabled. In add ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : True +IsNonContactCallbackEnabled : True +IsCallScreeningEnabled : True +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : True +AllowInboundPSTNCalls : True +IsAutomaticTranscriptionEnabled : False +IsAutomaticRecordingEnabled : False +``` This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is enabled to evaluate the call's context and pass the info to the user. @@ -80,6 +125,21 @@ This example shows that user1@contoso.com has personal attendant enabled. In add ``` Get-CsPersonalAttendantSettings -Identity user1@contoso.com ``` +```output +IsPersonalAttendantEnabled : True +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : User1 +DefaultTone : Formal +IsBookingCalendarEnabled : True +IsNonContactCallbackEnabled : True +IsCallScreeningEnabled : True +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : True +AllowInboundPSTNCalls : True +IsAutomaticTranscriptionEnabled : True +IsAutomaticRecordingEnabled : True +``` This example shows that user1@contoso.com has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is automatically storing call transcription and recording. @@ -87,6 +147,21 @@ This example shows that user1@contoso.com has personal attendant enabled. In add ``` Get-CsPersonalAttendantSettings -Identity user11@contoso.com ``` +```output +IsPersonalAttendantEnabled : False +DefaultLanguage : en-US +DefaultVoice : Female +CalleeName : +DefaultTone : Formal +IsBookingCalendarEnabled : False +IsNonContactCallbackEnabled : False +IsCallScreeningEnabled : True +AllowInboundInternalCalls : True +AllowInboundFederatedCalls : True +AllowInboundPSTNCalls : True +IsAutomaticTranscriptionEnabled : True +IsAutomaticRecordingEnabled : True +``` This example shows the default settings for the user that has never changed the personal attendant settings via Microsoft Teams. From e9d0bfe1a56adaa18c3d3b3e468147538ccccc73 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:12:49 -0700 Subject: [PATCH 13/26] Create Get-CsTeamsPersonalAttendantPolicy.md --- .../Get-CsTeamsPersonalAttendantPolicy.md | 111 ++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md new file mode 100644 index 0000000000..01c42fa033 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md @@ -0,0 +1,111 @@ +--- +external help file: Microsoft.Rtc.Management.dll-Help.xml +online version: https://learn.microsoft.com/powershell/module/teams/get-csteamspersonalattendantpolicy +applicable: Microsoft Teams +title: Get-CsTeamsPersonalAttendantPolicy +schema: 2.0.0 +author: juliiva +ms.author: juliiva +ms.reviewer: +manager: jomarque +--- + +# Get-CsTeamsPersonalAttendantPolicy + +## SYNOPSIS + +**Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. + +Returns information about the Teams personal attendant policies configured for use in your organization. +Teams personal attendant policies help determine which users are able to use personal attendant and its functionalities within Microsoft Teams. + +## SYNTAX + +### Identity (Default) +```powershell +Get-CsTeamsPersonalAttendantPolicy [-Identity ] [] +``` + +### Filter +```powershell +Get-CsTeamsPersonalAttendantPolicy [-Filter ] [] +``` + +## DESCRIPTION + +Returns information about the Teams personal attendant policies configured for use in your organization. +Teams personal attendant policies help determine which users are able to use personal attendant and its functionalities within Microsoft Teams. + +## EXAMPLES + +### Example 1 +```powershell +Get-CsTeamsPersonalAttendantPolicy -Identity SalesPersonalAttendantPolicy +``` + +Retrieves the personal attendant policy with the Identity "SalesPersonalAttendantPolicy". + +### Example 2 +```powershell +Get-CsTeamsPersonalAttendantPolicy -Filter "tag:Sales*" +``` + +Retrieves the personal attendant policies with Identity starting with Sales. + +## PARAMETERS + +### -Identity +Specify the TeamsPersonalAttendantPolicy that you would like to retrieve. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Filter +Enables you to use wildcard characters when indicating the policy (or policies) to be returned. +To return a collection of all the per-user policies, use this syntax: -Filter "tag:*". + +```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](https://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +The cmdlet is available in Teams PowerShell module 7.2.1-preview or later. + +## RELATED LINKS + +[New-CsTeamsPersonalAttendantPolicy](./new-csteamspersonalattendantpolicy.md) + +[Set-CsTeamsPersonalAttendantPolicy](./set-csteamspersonalattendantpolicy.md) + +[Grant-CsTeamsPersonalAttendantPolicy](./grant-csteamspersonalattendantpolicy.md) + +[Remove-CsTeamsPersonalAttendantPolicy](./remove-csteamspersonalattendantpolicy.md) From 4c37695d6753aa9cbda48c45289d6b9a06299bf6 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:14:22 -0700 Subject: [PATCH 14/26] Update Get-CsPersonalAttendantSettings.md --- .../MicrosoftTeams/Get-CsPersonalAttendantSettings.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md index bd61deb0f6..74e0fd7e61 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -6,9 +6,9 @@ Locale: en-US manager: jomarque Module Name: MicrosoftTeams ms.author: juliiva -online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-cspersonalattendantsettings +online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-csteamspersonalattendantpolicy schema: 2.0.0 -title: Get-CsPersonalAttendantSettings +title: Get-CsTeamsPersonalAttendantPolicy --- # Get-CsPersonalAttendantSettings From 3a1f3ed1e8896df41068b5d836f5e3b1b5a36c96 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:16:11 -0700 Subject: [PATCH 15/26] Update Get-CsTeamsPersonalAttendantPolicy.md --- .../Get-CsTeamsPersonalAttendantPolicy.md | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md index 01c42fa033..721d583679 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md @@ -21,14 +21,8 @@ Teams personal attendant policies help determine which users are able to use per ## SYNTAX -### Identity (Default) -```powershell -Get-CsTeamsPersonalAttendantPolicy [-Identity ] [] ``` - -### Filter -```powershell -Get-CsTeamsPersonalAttendantPolicy [-Filter ] [] +Get-CsTeamsPersonalAttendantPolicy [-Identity ] [-Filter ] [] ``` ## DESCRIPTION @@ -39,14 +33,14 @@ Teams personal attendant policies help determine which users are able to use per ## EXAMPLES ### Example 1 -```powershell +``` Get-CsTeamsPersonalAttendantPolicy -Identity SalesPersonalAttendantPolicy ``` Retrieves the personal attendant policy with the Identity "SalesPersonalAttendantPolicy". ### Example 2 -```powershell +``` Get-CsTeamsPersonalAttendantPolicy -Filter "tag:Sales*" ``` From 572c49f431a6fd7d4c13ac0f9ec999225be4ef2b Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:19:22 -0700 Subject: [PATCH 16/26] Create Grant-CsTeamsPersonalAttendantPolicy.md --- .../Grant-CsTeamsPersonalAttendantPolicy.md | 171 ++++++++++++++++++ 1 file changed, 171 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/Grant-CsTeamsPersonalAttendantPolicy.md diff --git a/teams/teams-ps/MicrosoftTeams/Grant-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Grant-CsTeamsPersonalAttendantPolicy.md new file mode 100644 index 0000000000..7c28c9d8f3 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Grant-CsTeamsPersonalAttendantPolicy.md @@ -0,0 +1,171 @@ +--- +applicable: Microsoft Teams +author: juliiva +external help file: Microsoft.Rtc.Management.dll-Help.xml +Locale: en-US +manager: jomarque +Module Name: MicrosoftTeams +ms.author: juliiva +online version: https://learn.microsoft.com/powershell/module/microsoftteams/grant-csteamspersonalattendantpolicy +schema: 2.0.0 +title: Grant-CsTeamsPersonalAttendantPolicy +--- + + +# Grant-CsTeamsPersonalAttendantPolicy + +## SYNOPSIS + +**Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. + +Assigns a specific Teams Personal Attendant Policy to a user, a group of users, or sets the Global policy instance. + +## SYNTAX + +```powershell +Grant-CsTeamsPersonalAttendantPolicy [-Identity ] [-PolicyName ] [-PassThru] [-Global] [-Rank ] [] +``` + +## DESCRIPTION +The Teams Personal Attendant Policies designate how users are able to use personal attendant and its functionalities within Microsoft Teams. This cmdlet allows admins to grant user level policies to individual users, to members of a group, or to set the Global policy instance. + +## EXAMPLES + +### Example 1 +``` +Grant-CsTeamsPersonalAttendantPolicy -identity user1@contoso.com -PolicyName SalesPersonalAttendantPolicy +``` + +Assigns the TeamsPersonalAttendantPolicy called "SalesPersonalAttendantPolicy" to user1@contoso.com + +### Example 2 +``` +Grant-CsTeamsPersonalAttendantPolicy -Global -PolicyName SalesPersonalAttendantPolicy +``` + +Assigns the TeamsPersonalAttendantPolicy called "SalesPersonalAttendantPolicy" to the Global policy instance. This sets the parameters in the Global policy instance to the values found +in the SalesPersonalAttendantPolicy instance. + +### Example 3 +``` +Grant-CsTeamsPersonalAttendantPolicy -Group sales@contoso.com -Rank 10 -PolicyName SalesPersonalAttendantPolicy +``` + +Assigns the TeamsPersonalAttendantPolicy called "SalesPersonalAttendantPolicy" to the members of the group sales@contoso.com. + +## PARAMETERS + +### -Identity +The user object to whom the policy is being assigned. + +```yaml +Type: String +Parameter Sets: (Identity) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyName +The name of the policy being assigned. To remove an existing user level policy assignment, specify PolicyName as $null. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PassThru +Enables you to pass a user object through the pipeline that represents the user being assigned the policy. By default, the Grant-CsTeamsPersonalAttendantPolicy cmdlet does not pass objects through the pipeline. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Global +Sets the parameters of the Global policy instance to the values in the specified policy instance. + +```yaml +Type: SwitchParameter +Parameter Sets: (GrantToTenant) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Group +Specifies the group used for the group policy assignment. + +```yaml +Type: String +Parameter Sets: (GrantToGroup) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Rank +The rank of the policy assignment, relative to other group policy assignments for the same policy type. + +```yaml +Type: Int32 +Parameter Sets: (GrantToGroup) +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +The cmdlet is available in Teams PowerShell module 7.2.1-preview or later. + +## RELATED LINKS + +[New-CsTeamsPersonalAttendantPolicy](./new-csteamspersonalattendantpolicy.md) + +[Set-CsTeamsPersonalAttendantPolicy](./set-csteamspersonalattendantpolicy.md) + +[Get-CsTeamsPersonalAttendantPolicy](./get-csteamspersonalattendantpolicy.md) + +[Remove-CsTeamsPersonalAttendantPolicy](./remove-csteamspersonalattendantpolicy.md) From 7d3dc123158f4ba7b0cc3e06642e9db46223e323 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:23:09 -0700 Subject: [PATCH 17/26] Create New-CsTeamsPersonalAttendantPolicy.md --- .../New-CsTeamsPersonalAttendantPolicy.md | 295 ++++++++++++++++++ 1 file changed, 295 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/New-CsTeamsPersonalAttendantPolicy.md diff --git a/teams/teams-ps/MicrosoftTeams/New-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/New-CsTeamsPersonalAttendantPolicy.md new file mode 100644 index 0000000000..a2a437a166 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/New-CsTeamsPersonalAttendantPolicy.md @@ -0,0 +1,295 @@ +--- +applicable: Microsoft Teams +author: juliiva +external help file: Microsoft.Rtc.Management.dll-Help.xml +Locale: en-US +manager: jomarque +Module Name: MicrosoftTeams +ms.author: juliiva +online version: https://learn.microsoft.com/powershell/module/microsoftteams/new-csteamspersonalattendantpolicy +schema: 2.0.0 +title: New-CsTeamsPersonalAttendantPolicy +--- + +# New-CsTeamsPersonalAttendantPolicy + +## SYNOPSIS + +**Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. + +Use this cmdlet to create a new instance of a Teams Personal Attendant Policy. + +## SYNTAX + +``` +New-CsTeamsPersonalAttendantPolicy [-Identity ] [-PersonalAttendant ] [-CallScreening ] [-CalendarBookings ] [-InboundInternalCalls ] [-InboundFederatedCalls ] [-InboundPSTNCalls ] [-AutomaticTranscription ] [-AutomaticRecording ] [-Confirm] [-Force] [-WhatIf] [] +``` + +## DESCRIPTION +The Teams Personal Attendant Policy controls personal attendant and its functionalities available to users in Microsoft Teams. This cmdlet allows admins to create new policy instances. + +## EXAMPLES + +### Example 1 +``` +New-CsTeamsPersonalAttendantPolicy -Identity SalesPersonalAttendantPolicy -CallScreening Enabled +``` + +The cmdlet create the policy instance SalesPersonalAttendantPolicy and sets the value of the parameter CallScreening to Enabled. The rest of the parameters are set to the corresponding +values in the Global policy instance. + +## PARAMETERS + +### -Identity +Name of the policy instance being created. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PersonalAttendant +Enables the user to use the personal attendant + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CallScreening +Enables the user to use the personal attendant call context evaluation features + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CalendarBookings +Enables the user to use the personal attendant calendar related features + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InboundInternalCalls +Enables the user to use the personal attendant for incoming domain calls + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InboundFederatedCalls +Enables the user to use the personal attendant for incoming calls from other domains + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InboundPSTNCalls +Enables the user to use the personal attendant for incoming PSTN calls + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AutomaticTranscription +Enables the user to use the automatic storing of personal attendant call transcriptions + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AutomaticRecording +Enables the user to use the automatic storing of personal attendant call recordings + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Force +Suppresses any confirmation prompts that would otherwise be displayed before making changes. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: False +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). + +## INPUTS + +### System.Management.Automation.PSObject + +## OUTPUTS + +### System.Object + +## NOTES + +The cmdlet is available in Teams PowerShell module 7.2.1-preview or later. + +## RELATED LINKS + +[Get-CsTeamsPersonalAttendantPolicy](./get-csteamspersonalattendantpolicy.md) + +[Set-CsTeamsPersonalAttendantPolicy](./set-csteamspersonalattendantpolicy.md) + +[Grant-CsTeamsPersonalAttendantPolicy](./grant-csteamspersonalattendantpolicy.md) + +[Remove-CsTeamsPersonalAttendantPolicy](./remove-csteamspersonalattendantpolicy.md) From c999e497beed65d6b8607c1ca9790d4b8b3ea357 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:25:17 -0700 Subject: [PATCH 18/26] Create Remove-CsTeamsPersonalAttendantPolicy.md --- .../Remove-CsTeamsPersonalAttendantPolicy.md | 118 ++++++++++++++++++ 1 file changed, 118 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/Remove-CsTeamsPersonalAttendantPolicy.md diff --git a/teams/teams-ps/MicrosoftTeams/Remove-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Remove-CsTeamsPersonalAttendantPolicy.md new file mode 100644 index 0000000000..a472467b17 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Remove-CsTeamsPersonalAttendantPolicy.md @@ -0,0 +1,118 @@ +--- +applicable: Microsoft Teams +author: juliiva +external help file: Microsoft.Rtc.Management.dll-Help.xml +Locale: en-US +manager: jomarque +Module Name: MicrosoftTeams +ms.author: juliiva +online version: https://learn.microsoft.com/powershell/module/microsoftteams/remove-csteamspersonalattendantpolicy +schema: 2.0.0 +title: Remove-CsTeamsPersonalAttendantPolicy +--- + +# Remove-CsTeamsPersonalAttendantPolicy + +## SYNOPSIS + +**Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. + +Use this cmdlet to remove an existing instance of a Teams Personal Attendant Policy or reset the Global policy instance to the default values. + +## SYNTAX + +``` +Remove-CsTeamsPersonalAttendantPolicy -Identity [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +This cmdlet removes an existing Teams Personal Attendant Policy instance or resets the Global policy instance to the default values. + +## EXAMPLES + +### Example 1 +``` +Remove-CsTeamsPersonalAttendantPolicy -Identity SalesPersonalAttendantPolicy +``` + +This example removes the Teams Personal Attendant Policy with identity SalesPersonalAttendantPolicy + +### Example 2 +``` +Remove-CsTeamsPersonalAttendantPolicy -Identity Global +``` + +This example resets the Global Personal Attendant Policy instance to the default values. + +## PARAMETERS + +### -Identity + The Identity parameter is the unique identifier of the Teams Personal Attendant Policy instance to remove or reset. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByPropertyName) +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +The cmdlet is available in Teams PowerShell module 7.2.1-preview or later. + +## RELATED LINKS + +[New-CsTeamsPersonalAttendantPolicy](./new-csteamspersonalattendantpolicy.md) + +[Get-CsTeamsPersonalAttendantPolicy](./get-csteamspersonalattendantpolicy.md) + +[Set-CsTeamsPersonalAttendantPolicy](./set-csteamspersonalattendantpolicy.md) + +[Grant-CsTeamsPersonalAttendantPolicy](./grant-csteamspersonalattendantpolicy.md) From e54b77dd8be88f4920ee6fab15f0b47d503b4c4c Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:28:20 -0700 Subject: [PATCH 19/26] Create Set-CsTeamsPersonalAttendantPolicy.md --- .../Set-CsTeamsPersonalAttendantPolicy.md | 304 ++++++++++++++++++ 1 file changed, 304 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/Set-CsTeamsPersonalAttendantPolicy.md diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Set-CsTeamsPersonalAttendantPolicy.md new file mode 100644 index 0000000000..615ec54416 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Set-CsTeamsPersonalAttendantPolicy.md @@ -0,0 +1,304 @@ +--- +applicable: Microsoft Teams +author: juliiva +external help file: Microsoft.Rtc.Management.dll-Help.xml +Locale: en-US +manager: jomarque +Module Name: MicrosoftTeams +ms.author: juliiva +online version: https://learn.microsoft.com/powershell/module/microsoftteams/set-csteamspersonalattendantpolicy +schema: 2.0.0 +title: Set-CsTeamsPersonalAttendantPolicy +--- + +# Set-CsTeamsPersonalAttendantPolicy + +## SYNOPSIS + +**Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. + +Use this cmdlet to update values in existing Teams Personal Attendant Policies. + +## SYNTAX + +``` +Set-CsTeamsPersonalAttendantPolicy [-Identity ] [-PersonalAttendant ] [-CallScreening ] [-CalendarBookings ] [-InboundInternalCalls ] [-InboundFederatedCalls ] [-InboundPSTNCalls ] [-AutomaticTranscription ] [-AutomaticRecording ] [-Confirm] [-Force] [-WhatIf] [] +``` + +## DESCRIPTION +The Teams Personal Attendant Policy controls personal attendant and its functionalities available to users in Microsoft Teams. This cmdlet allows admins to set values in +a given Personal Attendant Policy instance. + +Only the parameters specified are changed. Other parameters keep their existing values. + +## EXAMPLES + +### Example 1 +``` +Set-CsTeamsPersonalAttendantPolicy -Identity Global -CallScreening Disabled +``` + +Sets the value of the parameter CallScreening in the Global (default) Teams Personal Attendant Policy instance. + +### Example 2 +``` +Set-CsTeamsPersonalAttendantPolicy -Identity SalesPersonalAttendantPolicy -CalendarBookings Disabled +``` + +Sets the value of the parameter CalendarBookings to Disabled in the Teams Personal Attendant Policy instance called SalesPersonalAttendantPolicy. + +## PARAMETERS + +### -Identity +Name of the policy instance being created. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PersonalAttendant +Enables the user to use the personal attendant + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CallScreening +Enables the user to use the personal attendant call context evaluation features + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -CalendarBookings +Enables the user to use the personal attendant calendar related features + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InboundInternalCalls +Enables the user to use the personal attendant for incoming domain calls + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InboundFederatedCalls +Enables the user to use the personal attendant for incoming calls from other domains + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -InboundPSTNCalls +Enables the user to use the personal attendant for incoming PSTN calls + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AutomaticTranscription +Enables the user to use the automatic storing of personal attendant call transcriptions + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -AutomaticRecording +Enables the user to use the automatic storing of personal attendant call recordings + +Possible values: + +- EnabledUserOverride: Users can set their preferences from personal attendant settings in the Teams app. +- Enabled: Enables the user to use this functionality. +- Disabled: The user is not enabled to use this functionality. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: EnabledUserOverride +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Force +Suppresses any confirmation prompts that would otherwise be displayed before making changes. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: False +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). + +## INPUTS + +### System.Management.Automation.PSObject + +## OUTPUTS + +### System.Object + +## NOTES + +The cmdlet is available in Teams PowerShell module 7.2.1-preview or later. + +## RELATED LINKS + +[New-CsTeamsPersonalAttendantPolicy](./new-csteamspersonalattendantpolicy.md) + +[Get-CsTeamsPersonalAttendantPolicy](./get-csteamspersonalattendantpolicy.md) + +[Grant-CsTeamsPersonalAttendantPolicy](./grant-csteamspersonalattendantpolicy.md) + +[Remove-CsTeamsPersonalAttendantPolicy](./remove-csteamspersonalattendantpolicy.md) From 6b9901ea0db5f4db3c5d08cbfa6a418b36360a76 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:35:18 -0700 Subject: [PATCH 20/26] Update Get-CsTeamsPersonalAttendantPolicy.md --- .../MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md index 721d583679..5791585650 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md @@ -1,6 +1,6 @@ --- external help file: Microsoft.Rtc.Management.dll-Help.xml -online version: https://learn.microsoft.com/powershell/module/teams/get-csteamspersonalattendantpolicy +online version: https://learn.microsoft.com/powershell/module/micrososftteams/get-csteamspersonalattendantpolicy applicable: Microsoft Teams title: Get-CsTeamsPersonalAttendantPolicy schema: 2.0.0 From d246de24f9ee9c2056646ec10a0c41158971d18d Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:41:52 -0700 Subject: [PATCH 21/26] Update Get-CsTeamsPersonalAttendantPolicy.md --- .../MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md index 5791585650..7c200d7327 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md @@ -1,6 +1,6 @@ --- external help file: Microsoft.Rtc.Management.dll-Help.xml -online version: https://learn.microsoft.com/powershell/module/micrososftteams/get-csteamspersonalattendantpolicy +online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-csteamspersonalattendantpolicy applicable: Microsoft Teams title: Get-CsTeamsPersonalAttendantPolicy schema: 2.0.0 From 42e431c5609af1353963e64c2c1cc7850071101a Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 10:54:07 -0700 Subject: [PATCH 22/26] Update Get-CsTeamsPersonalAttendantPolicy.md --- .../MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md index 7c200d7327..508d9e4005 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md @@ -14,6 +14,8 @@ manager: jomarque ## SYNOPSIS +Test + **Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. Returns information about the Teams personal attendant policies configured for use in your organization. From 467ca5dcf274f8bd71ac4928b8804c1780c03882 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 11:21:41 -0700 Subject: [PATCH 23/26] Update Get-CsTeamsPersonalAttendantPolicy.md --- .../MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md index 508d9e4005..7c200d7327 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md @@ -14,8 +14,6 @@ manager: jomarque ## SYNOPSIS -Test - **Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. Returns information about the Teams personal attendant policies configured for use in your organization. From cf745085ba6698508b929a83d5e4edc313c4e28a Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 11:26:54 -0700 Subject: [PATCH 24/26] Update Get-CsTeamsPersonalAttendantPolicy.md --- .../Get-CsTeamsPersonalAttendantPolicy.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md index 7c200d7327..3d4f0402bb 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsTeamsPersonalAttendantPolicy.md @@ -1,13 +1,14 @@ --- -external help file: Microsoft.Rtc.Management.dll-Help.xml -online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-csteamspersonalattendantpolicy applicable: Microsoft Teams -title: Get-CsTeamsPersonalAttendantPolicy -schema: 2.0.0 author: juliiva -ms.author: juliiva -ms.reviewer: +external help file: Microsoft.Rtc.Management.dll-Help.xml +Locale: en-US manager: jomarque +Module Name: MicrosoftTeams +ms.author: juliiva +online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-csteamspersonalattendantpolicy +schema: 2.0.0 +title: Get-CsTeamsPersonalAttendantPolicy --- # Get-CsTeamsPersonalAttendantPolicy From 3f8d58aa3557555a142b3d783e53364c07b04888 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 11:39:40 -0700 Subject: [PATCH 25/26] Update MicrosoftTeams.md --- .../teams-ps/MicrosoftTeams/MicrosoftTeams.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md index 1a498ef064..09b0588616 100644 --- a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md +++ b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md @@ -137,6 +137,12 @@ Returns the identified Mainline attendant question and answer flow. ### [Get-CsMeetingMigrationStatus](Get-CsMeetingMigrationStatus.md) You use the `Get-CsMeetingMigrationStatus` cmdlet to check the status of meeting migrations. +### [Get-CsPersonalAttendantSettings](Get-CsPersonalAttendantSettings.md) +Returns the personal attendant settings for a user. + +### [Get-CsTeamsPersonalAttendantPolicy](Get-CsTeamsPersonalAttendantPolicy.md) +Returns information about the Teams personal attendant policies configured for use in your organization. + ### [Get-CsOnlineApplicationInstance](Get-CsOnlineApplicationInstance.md) Get application instance for the tenant from Microsoft Entra ID. @@ -674,6 +680,9 @@ Assigns a teams messaging policy at the per-user scope. Teams messaging policies ### [Grant-CsTeamsMobilityPolicy](Grant-CsTeamsMobilityPolicy.md) The TeamsMobilityPolicy allows Admins to control Teams mobile usage for users. +### [Grant-CsTeamsPersonalAttendantPolicy](Grant-CsTeamsPersonalAttendantPolicy.md) +Assigns a specific Teams Personal Attendant Policy to a user, a group of users, or sets the Global policy instance. + ### [Grant-CsTeamsRecordingRollOutPolicy](Grant-CsTeamsRecordingRollOutPolicy.md) The CsTeamsRecordingRollOutPolicy controls roll out of the change that governs the storage for meeting recordings. @@ -953,6 +962,9 @@ The TeamsMobilityPolicy allows Admins to control Teams mobile usage for users. ### [New-CsTeamsNetworkRoamingPolicy](New-CsTeamsNetworkRoamingPolicy.md) New-CsTeamsNetworkRoamingPolicy allows IT Admins to create policies for Network Roaming and Bandwidth Control experiences in Microsoft Teams. +### [New-CsTeamsPersonalAttendantPolicy](New-CsTeamsPersonalAttendantPolicy.md) +Create a new instance of a Teams Personal Attendant Policy. + ### [New-CsTeamsRecordingRollOutPolicy](New-CsTeamsRecordingRollOutPolicy.md) The CsTeamsRecordingRollOutPolicy controls roll out of the change that governs the storage for meeting recordings. @@ -1226,6 +1238,9 @@ Remove-CsTeamsNetworkRoamingPolicy allows IT Admins to delete policies for Netwo ### [Remove-CsTeamsNotificationAndFeedsPolicy](Remove-CsTeamsNotificationAndFeedsPolicy.md) Deletes an existing Teams Notification and Feeds Policy +### [Remove-CsTeamsPersonalAttendantPolicy](Remove-CsTeamsPersonalAttendantPolicy.md) +Deletes an instance of a Teams Personal Attendant Policy. + ### [Remove-CsTeamsRecordingRollOutPolicy](Remove-CsTeamsRecordingRollOutPolicy.md) The CsTeamsRecordingRollOutPolicy controls roll out of the change that governs the storage for meeting recordings. @@ -1367,6 +1382,9 @@ Modifies an existing Mainline Attendant appointment booking flow. ### [Set-CsMainlineAttendantQuestionAnswerFlow](Set-CsMainlineAttendantQuestionAnswerFlow.md) Modifies an existing Mainline Attendant question and answer (FAQ) flow. +### [Set-CsPersonalAttendantSettings](Set-CsPersonalAttendantSettings.md) +Modifies the personal attendant settings for a user. + ### [Set-CsOnlineApplicationInstance](Set-CsOnlineApplicationInstance.md) Updates an application instance in Microsoft Entra ID. @@ -1556,6 +1574,9 @@ The TeamsMobilityPolicy allows Admins to control Teams mobile usage for users. ### [Set-CsTeamsMultiTenantOrganizationConfiguration](Set-CsTeamsMultiTenantOrganizationConfiguration.md) This cmdlet configures the Multi-tenant Organization settings for the tenant. +### [Set-CsTeamsPersonalAttendantPolicy](Set-CsTeamsPersonalAttendantPolicy.md) +Update an existing Teams Personal Attendant Policies. + ### [Set-CsTeamsNetworkRoamingPolicy](Set-CsTeamsNetworkRoamingPolicy.md) Set-CsTeamsNetworkRoamingPolicy allows IT Admins to create or update policies for Network Roaming and Bandwidth Control experiences in Microsoft Teams. From 04e8e3eb887c10c27ba53b7d55efa9fb74d30721 Mon Sep 17 00:00:00 2001 From: Colin Longman Date: Wed, 6 Aug 2025 13:46:52 -0700 Subject: [PATCH 26/26] Update Get-CsPersonalAttendantSettings.md --- .../MicrosoftTeams/Get-CsPersonalAttendantSettings.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md index 74e0fd7e61..bd61deb0f6 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsPersonalAttendantSettings.md @@ -6,9 +6,9 @@ Locale: en-US manager: jomarque Module Name: MicrosoftTeams ms.author: juliiva -online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-csteamspersonalattendantpolicy +online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-cspersonalattendantsettings schema: 2.0.0 -title: Get-CsTeamsPersonalAttendantPolicy +title: Get-CsPersonalAttendantSettings --- # Get-CsPersonalAttendantSettings