次の方法で共有

コマンドレットを使用して通話キューを作成する

  • [アーティクル]
  • 適用対象:
    Skype for Business, Microsoft Teams

仮定

  1. コンピューターに PowerShell がインストールされている

    • コンピューターをWindows PowerShell用に設定する

    • MSTeams モジュールがインストール済み

      Install-Module -Name MicrosoftTeams -Force -AllowClobber

    • Microsoft Graph モジュールがインストールされました

      Install-Module -Name Microsoft.Graph -Force -AllowClobber

  2. テナント管理権限がある

  3. Microsoft Teams 電話を購入しました

  4. 以下に示すエージェント、配布リスト、および Teams チャネルは既に作成されています

注: 以下で使用する Teams チャネル コマンドレットは、Teams PowerShell モジュールのパブリック プレビュー バージョンの一部です。 詳細については、「 Teams PowerShell パブリック プレビューのインストール 」および 「Microsoft Teams PowerShell リリース ノート」も参照してください。

MicrosoftTeams モジュールが既にインストールされているユーザーは、最新のバージョンがインストールされていることを確認する必要があります Update-Module MicrosoftTeams 。

シナリオ

次の 3 つの呼び出しキューが作成されます。

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-ボイスメール-greeting.wav)
      • 文字起こしが有効
  • 通話タイムアウト処理: 45 分
    • リダイレクト: 共有ボイスメールをサポートする
      • TTS: "お待たせし、ボイスメールに通話を転送しています。
      • 文字起こしが有効

施設コラボレーション呼び出しキュー情報:

  • 自動応答によって前面に表示: いいえ
  • PSTN からの直接呼び出し: いいえ (内部呼び出しのみ)
  • 言語: フランス語 FR
  • あいさつ: なし
  • 保留音: 既定
  • 通話応答: チーム: 機能
  • 通話応答チャネル: ヘルプ デスク
    • チャネル所有者: Fred@contoso.com
  • 会議モード: オン
  • ルーティング方法: ラウンド ロビン
  • プレゼンス ベースのルーティング: オン
  • 通話エージェントは通話の取り消しをオプトアウトできます: いいえ
  • 通話エージェントのアラート時間: 15
  • 呼び出しオーバーフロー処理: 200
    • 切断
  • 通話タイムアウト処理: 45 分
    • 切断

ログイン

Teams 管理者の資格情報を入力するように求められます。

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

Sales Queue

オーディオ ファイルを作成する

"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) は、上記のコマンドレットで一覧表示されているライセンスの 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) は、上記のコマンドレットで一覧表示されているライセンスの 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) は、上記のコマンドレットで一覧表示されているライセンスの 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