cmdlet을 통해 통화 큐 만들기

아티클
12/16/2023
적용 대상:

Skype for Business, Microsoft Teams

가정

PowerShell이 컴퓨터에 설치됨
- Windows PowerShell 컴퓨터 설정
- MSTeams 모듈 설치됨
```
Install-Module -Name MicrosoftTeams -Force -AllowClobber
```
- 설치된 Microsoft Graph 모듈
```
Install-Module -Name Microsoft.Graph -Force -AllowClobber
```
테넌트 관리 권한이 있습니다.
Microsoft Teams 전화 구입했습니다.
아래에 언급된 에이전트, 배포 목록 및 Teams 채널이 이미 생성되었습니다.

참고: 아래에 사용된 Teams 채널 cmdlet은 Teams PowerShell 모듈의 공개 미리 보기 버전의 일부입니다. 자세한 내용은 Teams PowerShell 공개 미리 보기 설치 를 참조하고 Microsoft Teams PowerShell 릴리스 정보도 참조하세요.

MicrosoftTeams 모듈이 이미 설치된 사용자는 최신 버전이 설치되어 있는지 확인해야 합니다 Update-Module MicrosoftTeams .

시나리오

다음 세 개의 호출 큐가 만들어집니다.

Sales Call Queue 정보:

자동 전화 교환으로 앞장서기: 예
PSTN에서 직접 호출: 아니요
언어: 영어 미국
인사말: 없음
보류 중인 음악: 오디오 파일 재생
- 파일 이름: sales-hold-in-queue-music.wav
통화 응답: 사용자
- Bill@contoso.com
- Mary@contoso.com
회의 모드: 켜기
라우팅 방법: 전화 교환
현재 상태 기반 라우팅: 끄기
통화 에이전트는 전화를 옵트아웃할 수 있습니다. 예
통화 에이전트 경고 시간: 15
호출 오버플로 처리: 200
- 다음으로 리디렉션합니다. Adele@contoso.com
통화 시간 제한 처리: 120초
- 다음으로 리디렉션합니다. Adele@contoso.com

지원 통화 큐 정보:

자동 전화 교환으로 앞장서기: 예
PSTN에서 직접 호출: 아니요
언어: 영어 영국
인사말: 오디오 파일 재생
- 파일 이름: support-greeting.wav
보류 중인 음악: 오디오 파일 재생
- 파일 이름: support-hold-in-queue-music.wav
통화 응답: 지원 배포 목록
- Support@contoso.com
회의 모드: 켜기
라우팅 방법: 가장 긴 유휴 상태
프레즌스 기반 라우팅: N/A – 가장 긴 유휴 상태 때문에 기본적으로 켜기
통화 에이전트는 통화 걸기 옵트아웃할 수 있습니다. 아니요
통화 에이전트 경고 시간: 15
호출 오버플로 처리: 200
- 리디렉션: 공유 음성 메일 지원
  - 오디오 파일 재생(support-shared-voicemail-greeting.wav)
  - 전사 사용
통화 시간 제한 처리: 45분
- 리디렉션: 공유 음성 메일 지원
  - TTS: "계속 기다리게 되어 죄송합니다. 이제 음성 메일로 전화를 전송하고 있습니다."
  - 전사 사용

기능 협업 통화 큐 정보:

자동 전화 교환으로 전면: 아니요
PSTN에서 직접 호출: 아니요(내부 호출에만 해당)
언어: 프랑스어 FR
인사말: 없음
보류 중인 음악: 기본값
전화 응답: 팀: 시설
전화 응답 채널: 지원 센터
- 채널 소유자: Fred@contoso.com
회의 모드: 켜기
라우팅 방법: 라운드 로빈
현재 상태 기반 라우팅: 켜기
통화 에이전트는 통화 걸기 옵트아웃할 수 있습니다. 아니요
통화 에이전트 경고 시간: 15
호출 오버플로 처리: 200
- 연결 끊기
통화 시간 제한 처리: 45분
- 연결 끊기

Teams 관리자 자격 증명을 입력하라는 메시지가 표시됩니다.

$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential
Connect-MgGraph -Credential $credential

판매 큐

오디오 파일 만들기

"d:\"를 wav 파일이 컴퓨터에 저장되는 경로로 바꿉니다.

$content = [System.IO.File]::ReadAllBytes('d:\sales-hold-in-queue-music.wav')
$audioFileSalesHoldInQueueMusicID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "sales-hold-in-queue-music.wav" -Content $content).ID

사용자 ID 가져오기

$userAdeleID = (Get-CsOnlineUser -Identity "sip:adele@contoso.com").Identity
$userSalesBillID = (Get-CsOnlineUser -Identity "sip:bill@contoso.com").Identity
$userSalesMaryID = (Get-CsOnlineUser -Identity "sip:mary@contoso.com").Identity

지원되는 언어 목록 가져오기

Get-CsAutoAttendantSupportedLanguage

통화 큐 만들기

New-CsCallQueue -Name "Sales" -AgentAlertTime 15 -AllowOptOut $true -MusicOnHoldAudioFileID $audioFileSalesHoldInQueueMusicID -OverflowAction Forward -OverflowActionTarget $userAdeleID -OverflowThreshold 200 -TimeoutAction Forward -TimeoutActionTarget $userAdeleID -TimeoutThreshold 120 -RoutingMethod Attendant -ConferenceMode $true -User @($userSalesBillID, $userSalesMaryID) -LanguageID "en-US"

라이선스 유형 가져오기

Get-MgSubscribedSku

리소스 계정 만들기 및 할당

참고: 전화 큐가 자동 전화 교환으로 종료되므로 여기에 전화 번호가 필요하지 않습니다.

ApplicationID
- 자동 전화 교환: ce933385-9390-45d1-9512-c8d228074e07
- 통화 큐: 11cd3e2e-fccb-42ad-ad00-878b93575e07

참고: 아래 표시된 라이선스 유형(PHONESYSTEM_VIRTUALUSER)은 위의 cmdlet에 나열 Get-MgSubscribedSku 된 라이선스 유형이어야 합니다.

New-CsOnlineApplicationInstance -UserPrincipalName Sales-RA@contoso.com -DisplayName "Sales" -ApplicationID "11cd3e2e-fccb-42ad-ad00-878b93575e07"

Update-MgUser -UserId "Sales-RA@contoso.com" -UsageLocation US

Set-MgUserLicense -UserId "Sales-RA@contoso.com" -AddLicenses @(contoso:PHONESYSTEM_VIRTUALUSER) -RemoveLicenses @()

$applicationInstanceID = (Get-CsOnlineUser -Identity "Sales-RA@contoso.com").Identity
$callQueueID = (Get-CsCallQueue -NameFilter "Sales").Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($applicationInstanceID) -ConfigurationID $callQueueID -ConfigurationType CallQueue

지원 큐

오디오 파일 만들기

"d:\"를 wav 파일이 컴퓨터에 저장되는 경로로 바꿉니다.

$content1 = [System.IO.File]::ReadAllBytes('d:\support-greeting.wav')
$audioFileSupportGreetingID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-greeting.wav" -Content $content1).ID

$content2 = [System.IO.File]::ReadAllBytes('d:\support-hold-in-queue-music.wav')
$audioFileSupportHoldInQueueMusicID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-hold-in-queue-music.wav" -Content $content2).ID

$content3 = [System.IO.File]::ReadAllBytes('d:\support-shared-voicemail-greeting.wav')
$audioFileSupportSharedVoicemailGreetingID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-shared-voicemail-greeting.wav" -Content $content3).ID

지원 팀 그룹 ID 가져오기

$teamSupportID = (Get-Team -DisplayName "Support").GroupID

지원되는 언어 목록 가져오기

Get-CsAutoAttendantSupportedLanguage

통화 큐 만들기

New-CsCallQueue -Name "Support" -AgentAlertTime 15 -AllowOptOut $false -DistributionLists $teamSupportID -WelcomeMusicAudioFileID $audioFileSupportGreetingID -MusicOnHoldAudioFileID $audioFileSupportHoldInQueueMusicID -OverflowAction SharedVoicemail -OverflowActionTarget $teamSupportID -OverflowThreshold 200 -OverflowSharedVoicemailAudioFilePrompt $audioFileSupportSharedVoicemailGreetingID -EnableOverflowSharedVoicemailTranscription $true -TimeoutAction SharedVoicemail -TimeoutActionTarget $teamSupportID -TimeoutThreshold 2700 -TimeoutSharedVoicemailTextToSpeechPrompt "We're sorry to have kept you waiting and are now transferring your call to voicemail." -EnableTimeoutSharedVoicemailTranscription $true -RoutingMethod LongestIdle -ConferenceMode $true -LanguageID "en-US"

라이선스 유형 가져오기

Get-MgSubscribedSku

리소스 계정 만들기 및 할당

참고: 전화 큐는 자동 전화 교환에 의해 프런트 엔드이므로 여기에 전화 번호가 필요하지 않습니다.

ApplicationID
- 자동 전화 교환: ce933385-9390-45d1-9512-c8d228074e07
- 통화 큐: 11cd3e2e-fccb-42ad-ad00-878b93575e07

참고: 아래 표시된 라이선스 유형(PHONESYSTEM_VIRTUALUSER)은 위의 cmdlet에 나열 Get-MgSubscribedSku 된 라이선스 유형이어야 합니다.

New-CsOnlineApplicationInstance -UserPrincipalName Support-RA@contoso.com -DisplayName "Support" -ApplicationID "11cd3e2e-fccb-42ad-ad00-878b93575e07"

Update-MgUser -UserId "Support-RA@contoso.com" -UsageLocation US

Set-MgUserLicense -UserId "Support-RA@contoso.com" -AddLicenses @(contoso:PHONESYSTEM_VIRTUALUSER) -RemoveLicenses @()

$applicationInstanceID = (Get-CsOnlineUser -Identity "Support-RA@contoso.com").Identity
$callQueueID = (Get-CsCallQueue -NameFilter "Support").Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($applicationInstanceID) -ConfigurationID $callQueueID -ConfigurationType CallQueue

기능 공동 작업 통화 큐

시설 팀 그룹 ID 가져오기

$teamFacilitiesGroupID = (Get-Team -DisplayName "Facilities").GroupID

시설 지원 센터 팀 채널 ID 가져오기

Get-TeamChannel -GroupId $teamFacilitiesGroupID
$teamFacilitiesHelpDeskChannelID = "{assign ID from output of above command}"

시설 지원 센터 채널 소유자 사용자 ID 가져오기

$teamFacilitiesHelpDeskChannelUserID = (Get-TeamChannelUser -GroupId $teamFacilitiesGroupID -DisplayName "Help Desk" -Role Owner).UserId

리소스 계정 ID 호출 대신 가져오기

$oboResourceAccountID = (Get-CsOnlineUser -Identity "MainAA-RA@contoso.com").Identity

지원되는 언어 목록 가져오기

Get-CsAutoAttendantSupportedLanguage

통화 큐 만들기

New-CsCallQueue -Name "Facilities" -AgentAlertTime 15 -AllowOptOut $false -ChannelId $teamFacilitiesHelpDeskChannelID -ChannelUserObjectId $teamFacilitiesHelpDeskChannelUserID  -ConferenceMode $true -DistributionList $teamFacilitiesGroupID -LanguageID "fr-FR" -OboResourceAccountIds $oboResourceAccountID -OverflowAction DisconnectWithBusy -OverflowThreshold 200 -RoutingMethod RoundRobin -TimeoutAction Disconnect -TimeoutThreshold 2700 -UseDefaultMusicOnHold $true

라이선스 유형 가져오기

Get-MgSubscribedSku

리소스 계정 만들기 및 할당

참고: 전화 큐는 자동 전화 교환에 의해 프런트 엔드이므로 여기에 전화 번호가 필요하지 않습니다.

ApplicationID
- 자동 전화 교환: ce933385-9390-45d1-9512-c8d228074e07
- 통화 큐: 11cd3e2e-fccb-42ad-ad00-878b93575e07

참고: 아래 표시된 라이선스 유형(PHONESYSTEM_VIRTUALUSER)은 위의 cmdlet에 나열 Get-MgSubscribedSku 된 라이선스 유형이어야 합니다.

New-CsOnlineApplicationInstance -UserPrincipalName Facilities-RA@contoso.com -DisplayName "Facilities" -ApplicationID "11cd3e2e-fccb-42ad-ad00-878b93575e07"

Update-MgUser -UserId "Facilities-RA@contoso.com" -UsageLocation US

Set-MgUserLicense -UserId "Facilities-RA@contoso.com" -AddLicenses @(contoso:PHONESYSTEM_VIRTUALUSER) -RemoveLicenses @()

$applicationInstanceID = (Get-CsOnlineUser -Identity "Facilities-RA@contoso.com").Identity
$callQueueID = (Get-CsCallQueue -NameFilter "Facilities").Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($applicationInstanceID) -ConfigurationID $callQueueID -ConfigurationType CallQueue

다음을 통해 공유

cmdlet을 통해 통화 큐 만들기

가정

시나리오

판매 큐

오디오 파일 만들기

사용자 ID 가져오기

지원되는 언어 목록 가져오기

통화 큐 만들기

라이선스 유형 가져오기

리소스 계정 만들기 및 할당

지원 큐

오디오 파일 만들기

지원 팀 그룹 ID 가져오기

지원되는 언어 목록 가져오기

통화 큐 만들기

라이선스 유형 가져오기

리소스 계정 만들기 및 할당

기능 공동 작업 통화 큐

시설 팀 그룹 ID 가져오기

시설 지원 센터 팀 채널 ID 가져오기

시설 지원 센터 채널 소유자 사용자 ID 가져오기

리소스 계정 ID 호출 대신 가져오기

지원되는 언어 목록 가져오기

통화 큐 만들기

라이선스 유형 가져오기

리소스 계정 만들기 및 할당

피드백

피드백

추가 리소스

다음을 통해 공유

cmdlet을 통해 통화 큐 만들기

가정

시나리오

로그인

판매 큐

오디오 파일 만들기

사용자 ID 가져오기

지원되는 언어 목록 가져오기

통화 큐 만들기

라이선스 유형 가져오기

리소스 계정 만들기 및 할당

지원 큐

오디오 파일 만들기

지원 팀 그룹 ID 가져오기

지원되는 언어 목록 가져오기

통화 큐 만들기

라이선스 유형 가져오기

리소스 계정 만들기 및 할당

기능 공동 작업 통화 큐

시설 팀 그룹 ID 가져오기

시설 지원 센터 팀 채널 ID 가져오기

시설 지원 센터 채널 소유자 사용자 ID 가져오기

리소스 계정 ID 호출 대신 가져오기

지원되는 언어 목록 가져오기

통화 큐 만들기

라이선스 유형 가져오기

리소스 계정 만들기 및 할당

피드백

피드백

추가 리소스