Get-CsCommonAreaPhone

Skype for Business Server 2015
 

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

Возвращает сведения о телефонах общего пользования, управление которыми осуществляется с помощью Skype для бизнеса Server 2015. Телефоны общего пользования — это телефоны, установленные в вестибюлях зданий, комнатах отдыха или других местах, где они используются широким кругом людей для разных целей. Данный командлет впервые появился в Lync Server 2010.

Get-CsCommonAreaPhone [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Команда, показанная в примере 1, возвращает сведения о всех телефонах общего пользования, настроенных для использования в организации. Для этого вызывается командлет Get-CsCommonAreaPhone без параметров.

Get-CsCommonAreaPhone

В примере 2 возвращаются сведения о телефоне общего пользования с отображаемым именем Active Directory "Building 14 Lobby". Для этого используется параметр Filter со значением фильтра {DisplayName -eq "Building 14 Lobby"}. Это значение ограничивает возвращаемые объекты только теми телефонами общего пользования, свойство DisplayName которых равно "Building 14 Lobby".

Get-CsCommonAreaPhone -Filter {DisplayName -eq "Building 14 Lobby"}

В примере 3 возвращаются все телефоны общего пользования, отображаемые имена Active Directory которых начинаются со строки "Building 14". Для этого вызывается командлет Get-CsCommonAreaPhone с параметром Filter, для которого задано значение {DisplayName -like "Building 14*"}. В значении фильтра используется оператор -like и строка шаблона "Building 14*" для ограничения возвращаемых данных только теми телефонами, значения свойства DisplayName которых начинаются со строки "Building 14" (например, "Building 14 Lobby", "Building 14 Cafeteria" и т. д.).

Get-CsCommonAreaPhone  -Filter {DisplayName -like "Building 14*"}

В примере 4 возвращается отдельный телефон общего пользования, свойство LineUri которого имеет значение "tel:+14255551234". Поскольку значение свойства LineUris должно быть уникальным, эта команда всегда возвращает только один объект.

Get-CsCommonAreaPhone  -Filter {LineUri -eq "tel:+14255551234"}

Команда, показанная в примере 5, возвращает сведения о всех телефонах общего пользования, которым не была назначена абонентская группа. Для этого используется параметр Filter со значением {DialPlan -eq $Null}. Он ограничивает возвращаемые данные только теми телефонами, свойство DialPlan которых имеет значение null. Если телефону общего пользования явным образом не назначена абонентская группа, для него автоматически используется глобальная абонентская группа или, если таковой не существует, абонентская группа, назначенная сайту.

Get-CsCommonAreaPhone -Filter {DialPlan -eq $Null}

В примере 6 возвращается коллекция, включающая все телефоны общего пользования, которые имеют контактный объект в подразделении Telecommunications в доменных службах Active Directory. Для этого вызывается командлет Get-CsCommonAreaPhone с параметром OU. Значение параметра ограничивает возвращаемые данные только теми телефонами, которые имеют контактные объекты в подразделении с различающимся именем ou=Telecommunications,dc=litwareinc,dc=com.

Get-CsCommonAreaPhone -OU "ou=Telecommunications,dc=litwareinc,dc=com"

Телефоны общего пользования — это IP-телефоны, не предназначенные для применения отдельным пользователем. Телефоны общего пользования обычно располагаются не в чьем-то кабинете, а в приемных, кафетериях, комнатах отдыха, переговорных и других местах, где обычно собирается большое количество людей. Так как в Skype для бизнеса Server 2015 управление телефонами обычно осуществляется на основе политик голосовых вызовов и абонентских групп, назначаемых отдельным пользователям, то управление подобными телефонами будет представлять для администраторов непростую задачу.

Решением этой задачи является создание контактных объектов Active Directory для всех телефонов общего пользования. (Эти контактные объекты можно создать с помощью командлета New-CsCommonAreaPhone .) Так же как и учетным записям пользователей, этим контактным объектам можно назначать политики и планы голосовой связи. Это позволяет обеспечить контроль над телефонами общего пользования несмотря на то, что они не связаны с отдельным пользователем. Например, чтобы запретить переключение или парковку вызовов, выполняемых с телефона общего пользования, можно создать соответствующую политику голосовой связи и затем назначить ее телефону общего пользования (или, если точнее, представляющему его контактному объекту). Например, следующая команда назначает политику голосовой связи CommonAreaPhoneVoicePolicy всем телефонам общего пользования.

Get-CsCommonAreaPhone | Grant-CsVoicePolicy -PolicyName "CommonAreaPhoneVoicePolicy"

Командлет Get-CsCommonAreaPhone позволяет извлекать сведения о телефонах общего пользования, настроенных для использования в организации. Если вызвать командлет Get-CsCommonAreaPhone без параметров, он вернет сведения о всех телефонах общего пользования. Дополнительные параметры обеспечивают различные способы фильтрации данных. Например, можно получить сведения о всех телефонах общего пользования, которые имеют контактные объекты в указанном подразделении, или о всех контактных объектах в указанном здании.

 

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

Credential

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

System.Management.Automation.PSCredential

Позволяет запускать командлет Get-CsCommonAreaPhone с другими учетными данными. Используется, когда у учетной записи, с использованием которой был выполнен вход в Windows, нет необходимых прав для работы с объектами контактов.

Для использования параметра Credential сначала требуется создать объект PSCredential с помощью командлета Get-Credential . Дополнительные сведения см. в разделе справки, посвященном командлету Get-Credential .

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

Позволяет подключиться к определенному контроллеру домена для получения контактных данных. Для подключения к определенному контроллеру используйте параметр DomainController, указав после него полное доменное имя соответствующего компьютера (например, atl-cs-001.litwareinc.com).

Filter

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

System.String

Позволяет ограничить возвращаемые данные, фильтруя их по атрибутам, связанным с Skype для бизнеса Server 2015. Например, можно ограничить возвращаемые данные контактными объектами телефонов общего пользования, которым назначена определенная политика голосовой связи, или контактами, которым не назначена определенная политика голосовой связи.

Параметр Filter использует тот же синтаксис фильтрации Windows PowerShell, что и командлет Where-Object .

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

Уникальный идентификатор телефона общего пользования. Телефоны общего пользования идентифицируются по различающемуся имени Active Directory соответствующего контактного объекта. По умолчанию в качестве общего имени телефона общего пользования используется глобальный уникальный идентификатор (GUID). Это означает, что идентификатор телефона, как правило, выглядит следующим образом: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

LdapFilter

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

System.String

Позволяет ограничить возвращаемые данные путем фильтрации по универсальным атрибутам Active Directory (т. е. атрибутам, которые не связаны именно с Skype для бизнеса Server 2015). Например, можно ограничить возвращаемые данные объектами контактов, которые назначены конкретному отделу или расположены в конкретном здании.

В параметре LdapFilter для создания фильтров используется язык запросов LDAP. Например, фильтр, возвращающий только те контактные объекты, которые представляют телефоны общего пользования в городе Редмонд, выглядит следующим образом:

-LDAPFilter "l=Redmond"

В предыдущем примере символ "l" (строчная буква L) — это атрибут Active Directory (расположение), символ "=" — это оператор сравнения (равно), а слово "Redmond" — это значение фильтра.

OU

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

Microsoft.Rtc.Management.AD.OUIdParameter

Позволяет вернуть контактные объекты из определенного подразделения Active Directory. Параметр OU возвращает данные как из указанного подразделения, так и из его дочерних подразделений. Например, если подразделение Finance имеет два дочерних подразделения (AccountsPayable и AccountsReceivable), будут возвращены сведения о телефонах общего пользования для каждого из них.

При указании подразделения используйте различающееся имя этого контейнера; например: -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Позволяет ограничить число записей, возвращаемых командой. Например, чтобы вернуть сведения о семи телефонах общего пользования (вне зависимости от того, сколько их имеется в лесу), добавьте параметр ResultSize со значением 7. Имейте в виду, что невозможно указать, сведения о каких именно телефонах должны быть возвращены. Если для параметра ResultSize задано значение 7, но в лесу имеется всего три телефона общего пользования, команда вернет сведения об этих трех телефонах и завершится без ошибки.

В качестве размера результатов может быть указано любое целое число в диапазоне от 0 до 2147483647 включительно. При задании значения "0" команда будет выполняться, но данные возвращаться не будут.

Строка. Командлет Get-CsCommonAreaPhone принимает переданное по конвейеру строковое значение, представляющее идентификатор телефона общего пользования.

Командлет Get-CsCommonAreaPhone возвращает экземпляры объекта Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

 
Показ: