|
| 1 | +--- |
| 2 | +applicable: Microsoft Teams |
| 3 | +author: juliiva |
| 4 | +external help file: Microsoft.Rtc.Management.dll-Help.xml |
| 5 | +Locale: en-US |
| 6 | +manager: jomarque |
| 7 | +Module Name: MicrosoftTeams |
| 8 | +ms.author: juliiva |
| 9 | +online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-cspersonalattendantsettings |
| 10 | +schema: 2.0.0 |
| 11 | +title: Get-CsPersonalAttendantSettings |
| 12 | +--- |
| 13 | + |
| 14 | +# Get-CsPersonalAttendantSettings |
| 15 | + |
| 16 | +## SYNOPSIS |
| 17 | + |
| 18 | +**Limited Preview:** Functionality described in this document is currently in limited preview and only authorized organizations have access. |
| 19 | + |
| 20 | +This cmdlet will show personal attendant settings for a user. |
| 21 | + |
| 22 | +## SYNTAX |
| 23 | + |
| 24 | +``` |
| 25 | +Get-CsPersonalAttendantSettings -Identity <String> [<CommonParameters>] |
| 26 | +``` |
| 27 | + |
| 28 | +## DESCRIPTION |
| 29 | + |
| 30 | +This cmdlet shows the personal attendant settings for a user. |
| 31 | + |
| 32 | +## EXAMPLES |
| 33 | + |
| 34 | +### Example 1 |
| 35 | +``` |
| 36 | +Get-CsPersonalAttendantSettings -Identity [email protected] |
| 37 | +``` |
| 38 | +```output |
| 39 | +IsPersonalAttendantEnabled : True |
| 40 | +DefaultLanguage : en-US |
| 41 | +DefaultVoice : Female |
| 42 | +CalleeName : User1 |
| 43 | +DefaultTone : Formal |
| 44 | +IsBookingCalendarEnabled : False |
| 45 | +IsNonContactCallbackEnabled : False |
| 46 | +IsCallScreeningEnabled : False |
| 47 | +AllowInboundInternalCalls : True |
| 48 | +AllowInboundFederatedCalls : False |
| 49 | +AllowInboundPSTNCalls : False |
| 50 | +IsAutomaticTranscriptionEnabled : False |
| 51 | +IsAutomaticRecordingEnabled : False |
| 52 | +``` |
| 53 | + |
| 54 | +This example shows that [email protected] has personal attendant enabled (personal attendant communicates in English). Personal attendant will refer to its owner as User1. |
| 55 | +Personal attendant is only enabled for inbound Teams calls from the user's ___domain. Additional capabilities are turned off. |
| 56 | + |
| 57 | +### Example 2 |
| 58 | +``` |
| 59 | +Get-CsPersonalAttendantSettings -Identity [email protected] |
| 60 | +``` |
| 61 | +```output |
| 62 | +IsPersonalAttendantEnabled : True |
| 63 | +DefaultLanguage : en-US |
| 64 | +DefaultVoice : Female |
| 65 | +CalleeName : User1 |
| 66 | +DefaultTone : Formal |
| 67 | +IsBookingCalendarEnabled : True |
| 68 | +IsNonContactCallbackEnabled : False |
| 69 | +IsCallScreeningEnabled : False |
| 70 | +AllowInboundInternalCalls : True |
| 71 | +AllowInboundFederatedCalls : False |
| 72 | +AllowInboundPSTNCalls : False |
| 73 | +IsAutomaticTranscriptionEnabled : False |
| 74 | +IsAutomaticRecordingEnabled : False |
| 75 | +``` |
| 76 | + |
| 77 | +This example shows that [email protected] has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is able to access personal bookings calendar, |
| 78 | +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. |
| 79 | + |
| 80 | +### Example 3 |
| 81 | +``` |
| 82 | +Get-CsPersonalAttendantSettings -Identity [email protected] |
| 83 | +``` |
| 84 | +```output |
| 85 | +IsPersonalAttendantEnabled : True |
| 86 | +DefaultLanguage : en-US |
| 87 | +DefaultVoice : Female |
| 88 | +CalleeName : User1 |
| 89 | +DefaultTone : Formal |
| 90 | +IsBookingCalendarEnabled : True |
| 91 | +IsNonContactCallbackEnabled : True |
| 92 | +IsCallScreeningEnabled : False |
| 93 | +AllowInboundInternalCalls : True |
| 94 | +AllowInboundFederatedCalls : True |
| 95 | +AllowInboundPSTNCalls : True |
| 96 | +IsAutomaticTranscriptionEnabled : False |
| 97 | +IsAutomaticRecordingEnabled : False |
| 98 | +``` |
| 99 | + |
| 100 | +This example shows that [email protected] 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. |
| 101 | + |
| 102 | +### Example 4 |
| 103 | +``` |
| 104 | +Get-CsPersonalAttendantSettings -Identity [email protected] |
| 105 | +``` |
| 106 | +```output |
| 107 | +IsPersonalAttendantEnabled : True |
| 108 | +DefaultLanguage : en-US |
| 109 | +DefaultVoice : Female |
| 110 | +CalleeName : User1 |
| 111 | +DefaultTone : Formal |
| 112 | +IsBookingCalendarEnabled : True |
| 113 | +IsNonContactCallbackEnabled : True |
| 114 | +IsCallScreeningEnabled : True |
| 115 | +AllowInboundInternalCalls : True |
| 116 | +AllowInboundFederatedCalls : True |
| 117 | +AllowInboundPSTNCalls : True |
| 118 | +IsAutomaticTranscriptionEnabled : False |
| 119 | +IsAutomaticRecordingEnabled : False |
| 120 | +``` |
| 121 | + |
| 122 | +This example shows that [email protected] 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. |
| 123 | + |
| 124 | +### Example 5 |
| 125 | +``` |
| 126 | +Get-CsPersonalAttendantSettings -Identity [email protected] |
| 127 | +``` |
| 128 | +```output |
| 129 | +IsPersonalAttendantEnabled : True |
| 130 | +DefaultLanguage : en-US |
| 131 | +DefaultVoice : Female |
| 132 | +CalleeName : User1 |
| 133 | +DefaultTone : Formal |
| 134 | +IsBookingCalendarEnabled : True |
| 135 | +IsNonContactCallbackEnabled : True |
| 136 | +IsCallScreeningEnabled : True |
| 137 | +AllowInboundInternalCalls : True |
| 138 | +AllowInboundFederatedCalls : True |
| 139 | +AllowInboundPSTNCalls : True |
| 140 | +IsAutomaticTranscriptionEnabled : True |
| 141 | +IsAutomaticRecordingEnabled : True |
| 142 | +``` |
| 143 | + |
| 144 | +This example shows that [email protected] has personal attendant enabled. In addition to previously mentioned capabilities, personal attendant is automatically storing call transcription and recording. |
| 145 | + |
| 146 | +### Example 6 |
| 147 | +``` |
| 148 | +Get-CsPersonalAttendantSettings -Identity [email protected] |
| 149 | +``` |
| 150 | +```output |
| 151 | +IsPersonalAttendantEnabled : False |
| 152 | +DefaultLanguage : en-US |
| 153 | +DefaultVoice : Female |
| 154 | +CalleeName : |
| 155 | +DefaultTone : Formal |
| 156 | +IsBookingCalendarEnabled : False |
| 157 | +IsNonContactCallbackEnabled : False |
| 158 | +IsCallScreeningEnabled : True |
| 159 | +AllowInboundInternalCalls : True |
| 160 | +AllowInboundFederatedCalls : True |
| 161 | +AllowInboundPSTNCalls : True |
| 162 | +IsAutomaticTranscriptionEnabled : True |
| 163 | +IsAutomaticRecordingEnabled : True |
| 164 | +``` |
| 165 | + |
| 166 | +This example shows the default settings for the user that has never changed the personal attendant settings via Microsoft Teams. |
| 167 | + |
| 168 | +## PARAMETERS |
| 169 | + |
| 170 | +### -Identity |
| 171 | +The Identity of the user to show personal attendant settings for. Can be specified using the ObjectId or the SIP address. |
| 172 | + |
| 173 | +```yaml |
| 174 | +Type: System.String |
| 175 | +Parameter Sets: (All) |
| 176 | +Aliases: |
| 177 | + |
| 178 | +Required: True |
| 179 | +Position: Named |
| 180 | +Default value: None |
| 181 | +Accept pipeline input: False |
| 182 | +Accept wildcard characters: False |
| 183 | +``` |
| 184 | +
|
| 185 | +### CommonParameters |
| 186 | +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). |
| 187 | +
|
| 188 | +## INPUTS |
| 189 | +
|
| 190 | +### None |
| 191 | +
|
| 192 | +## OUTPUTS |
| 193 | +
|
| 194 | +### System.Object |
| 195 | +
|
| 196 | +## NOTES |
| 197 | +The cmdlet is available in Teams PowerShell module 7.3.0 or later. |
| 198 | +
|
| 199 | +## RELATED LINKS |
| 200 | +
|
| 201 | +[Set-CsPersonalAttendantSettings](./set-cspersonalattendantsettings.md) |
0 commit comments