Get-CsAnnouncement

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Возвращает сведения об оповещениях Skype для бизнеса Server 2015, настроенных в вашей организации. Оповещения воспроизводятся, когда пользователи звонят на правильный, но не назначенный номер телефона. В качестве оповещения может использоваться сообщение (например, "Этот номер временно не обслуживается") или сигнал "занято". Данный командлет впервые появился в Lync Server 2010.

Get-CsAnnouncement [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsAnnouncement [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

В примере 1 извлекаются все оповещения, настроенные в организации. Это делается путем вызова командлета Get-CsAnnouncement без параметров.

Get-CsAnnouncement

Команда, показанная в примере 2, извлекает только одно оповещение, которое имеет удостоверение ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90. Другой (возможно, более простой) способ извлечения конкретного оповещения показан в примере 5.

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90" 

Команда, показанная в примере 3, извлекает сведения о всех оповещениях, настроенных для службы ApplicationServer:redmond.litwareinc.com.

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com"

В примере 4 извлекаются сведения о всех оповещениях, настроенных для узла Redmond (во всех доменах). Это делается путем включения параметра Filter и значения фильтра "*ApplicationServer:Redmond*", что ограничивает извлекаемые данные только оповещениями, удостоверение которых содержит строку "ApplicationServer:Redmond". По определению это оповещения, настроенные для узла Redmond.

Get-CsAnnouncement -Filter "*ApplicationServer:Redmond*"

В примере 5 показывается другой способ извлечения конкретного оповещения или ряда оповещений; в данном случае извлекаются все оповещения с именем Welcome Announcement. Для этого сначала вызывается командлет Get-CsAnnouncement без параметров, чтобы получить коллекцию всех оповещений, используемых в организации. Затем эта коллекция передается в командлет Where-Object , который отбирает те оповещения, имя (Name) которых соответствует (-eq) значению "Welcome Announcement".

Get-CsAnnouncement | Where-Object {$_.Name -eq "Welcome Announcement"}

Пример 6 аналогичен примеру 5, но в нем показан другой способ извлечения единственного оповещения. Снова вызывается командлет Get-CsAnnouncement , но на этот раз указывается параметр Identity со значением ApplicationServer:redmond.litwareinc.com. Это извлекает коллекцию всех оповещений, связанных с указанной службой. Затем, как и в примере 5, эта коллекция передается в командлет Where-Object , который отбирает оповещения с именем "Welcome Announcement". Поскольку в рамках службы приложения имена оповещений должны быть уникальны, эта команда всегда извлекает не более одного элемента.

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com" | Where-Object {$_.Name -eq "Welcome Announcement"}

Этот пример аналогичен примеру 5, в котором сначала извлекаются все оповещения, а затем их коллекция передается в командлет Where-Object . Однако в примере 5 в предложении where использовался оператор –eq (равно), чтобы найти точное соответствие имени. В данном примере используется оператор –like и значение с подстановочным знаком, чтобы найти все оповещения, которые в данном случае начинаются со строки Welcome.

Get-CsAnnouncement | Where-Object {$_.Name -like "Welcome*"}

В примере 8 извлекаются сведения для всех оповещений, которые используют запрос с преобразованием текста в речь (либо в качестве основного оповещения, либо как переход к звуковому файлу), но не используют в качестве языка американский английский. Для выполнения этой задачи команда сначала вызывает командлет Get-CsAnnouncement , чтобы получить коллекцию всех оповещений, настроенных в текущий момент. Затем эта коллекция передается в командлет Where-Object , который выбирает все оповещения, имеющие заданное свойство TextToSpeechPrompt (т.е. значение свойства не равно $Null), и значение свойства Language которых не равно (-ne) en-US.

Get-CsAnnouncement | Where-Object {($_.TextToSpeechPrompt -ne $Null) -and ($_.Language -ne "en-US")}

В организации могут быть телефонные номера, которые не назначены пользователям или телефонам, но при этом действующие, на которые можно позвонить. По умолчанию при звонке на один из таких номеров воспроизводится сигнал занятости, и такой звонок может привести к ошибке в клиенте SIP. Применяя параметры оповещений к неназначенным номерам, администраторы могут выбрать воспроизведение сообщения, воспроизведение сигнала занятости или перенаправление звонка. Данный командлет возвращает один или несколько таких параметров оповещений.

По умолчанию право на локальный запуск командлета Get-CsAnnouncement имеют члены следующих групп: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все самостоятельно созданные роли RBAC), выполните в командной строке Windows PowerShell следующую команду:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAnnouncement"}

 

Параметр Обязательный? Тип Описание

Filter

Необязательный

System.String

Этот параметр позволяет выполнять поиск с подстановочными знаками по удостоверениям всех оповещений, настроенных в организации. Используйте подстановочный знак (*), чтобы фильтровать любую часть удостоверения.

Identity

Необязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

Идентификатор оповещения, которое требуется извлечь. Если не указан этот параметр и параметр Filter, то будут извлечены все экземпляры оповещений, настроенные в организации. Значение для параметра Identity можно представить одним из следующих двух способов.

- Ввести удостоверение службы приложения для оповещений, которые требуется извлечь. В результате будут извлечены все оповещения, настроенные с указанным удостоверением службы. Например: ApplicationServer:Redmond.litwareinc.com.

- Ввести полное удостоверение одного оповещения, которое требуется извлечь. Это значение всегда будет в формате <ИД_службы>/<GUID>, где ИД_службы — это удостоверение сервера приложений, на котором работает служба оповещений, а GUID — это глобальный уникальный идентификатор, связанный с этим оповещением. Например: ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

LocalStore

Необязательный

System.Management.Automation.SwitchParameter

Извлекает сведения об оповещении не из самого центрального хранилища управления, а из локальной реплики центрального хранилища управления.

Возвращает один или несколько экземпляров объекта Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement.

 
Показ: