Set-CsLisPort

Skype for Business Server 2015
 

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

Создает сервер информирования о расположении (LIS) порта, привязывает порт к месту (при необходимости создавая новое местоположение) или изменяет существующий порт и его расположением. Связь порта с местом используется в корпоративной голосовой связи Enhanced 9-1-1 (E9-1-1) для сообщения оператору экстренной службы о расположении абонента. Данный командлет впервые появился в Lync Server 2010.

Set-CsLisPort -ChassisID <String> -PortID <String> [-City <String>] [-CompanyName <String>] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] <COMMON PARAMETERS>
Set-CsLisPort -ChassisID <String> -PortID <String> [-Description <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] <COMMON PARAMETERS>
Set-CsLisPort -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

В примере 1 создается или обновляется запись о расположении LIS-порта. Команда в этом примере включает три параметра: ChassisID, PortID и PortIDSubtype. В качестве значения ChassisID задается MAC-адрес 99-99-99-99-99-99, для PortID указывается значение 4200, а для PortIDSubType — 1. Следует отметить, что 1 в качестве значения PortIDSubType преобразуется в значение InterfaceAlias. Этот параметр и его значение также могут выглядеть следующим образом: -PortIDSubType InterfaceAlias. Эти три параметра требуются для создания уникального экземпляра расположения порта.

Обратите внимание, что в данном примере не указан адрес. Запись порта на сервере информирования о расположении можно создать без привязки к адресу. Однако в этом случае экстренные вызовы, направляемые к этому порту могут содержать недостаточно информации для определения расположения (в зависимости от подсети или способа переключения расположений).

ВНИМАНИЕ: Если расположение LIS-порта с такой комбинацией клавиш уже существует, оно заменяется значениями из этой команды. Это значит, что если адрес порта (физическое расположение) уже задан, эта привязка становится недействительной, так как команда не содержит информации о расположении. Данные о расположении все еще будут находиться в базе местонахождений, но оно больше не будет привязано к порту.

Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1

В примере 2 порту, созданном в примере 1, назначается адрес. Если адреса нет в базе местонахождений, командлет создает его.

Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIdSubType 1 -Location "30/1000" -HouseNumber 1234 -PreDirectional NE -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999

В этом примере обновляются все расположения портов с MAC-адресом (ChassisID) 99-99-99-99-99-88. Первая строка начинается с вызова командлета Get-CsLisPort , который собирает информацию о всех портах службы LIS. Эта коллекция портов передается в командлет Where-Object , который находит все элементы со значением ChassisID, равным (-eq) 99-99-99-99-99-88. Коллекция портов с ChassisID 99-99-99-99-99-88 присваивается переменной $a.

Во второй строке примера содержимое переменной $a передается (коллекция LIS-портов с ChassisID 99-99-99-99-99-88) командлету Set-CsLisPort . Командлет обновляет указанные значения (Location, HouseNumber, StreetName, StreetSuffix, City, State, Country и PostalCode) для каждого пункта.

$a = Get-CsLisPort | Where-Object {$_.ChassisID -eq "99-99-99-99-99-88"}
$a | Set-CsLisPort -Location "30/1000" -HouseNumber 1234 -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999

Enhanced 9-1-1 позволяет оператору экстренной службы определять местоположение вызова, не спрашивая абонента. Если для звонка используется протокол VoIP, получение этой информации зависит от различных параметров соединения. VoIP-администратор должен настроить схему местонахождения (так называемую карту географических соответствий), определяющую местонахождение абонента. Этот командлет позволяет администратору составить план физического местонахождения и отправить его на порт, к которому подключен клиент.

Комбинация ChassisID, PortID и PortIDSubType позволяет создать уникальное расположение порта. Если введенная комбинация клавиш ChassisID/PortID/PortIDSubType уже существует, командлет обновляет расположение порта с учетом указанных параметров. Если сочетания клавиш не существует, создается новое расположение порта.

Если введенный адрес, полностью совпадающий с параметрами расположения (включая нулевые значения), отсутствует в базе местонахождений, создается новый адрес с учетом параметров данного командлета. Со списком местонахождений можно ознакомиться с помощью командлета Get-CsLisLocation . Для командлета Set-CsLisPort параметры расположения указывать не требуется; запись порта можно создавать без привязки к месту. Данный командлет также позволяет указывать недействительное расположение. Действительное расположение содержит, как минимум, такие параметры, как Location, HouseNumber, StreetName, City, State и Country. Если хотя бы один из этих параметров не указан, вызовы, поступающие на порт, могут содержать недостаточно информации для оператора экстренной службы (в зависимости от наличия действительных параметров для точек переключения, подсети или беспроводной точки доступа, которые могут использоваться вместо параметров порта). Параметры расположения рекомендуется задавать как можно точнее.

Одним из необходимых параметров этого командлета является ChassisID. ChassisID — это адрес уровня управления доступом к среде передачи (MAC) сетевого коммутатора порта. Если коммутатора нет в базе местонахождений, командлет создает его. Информацию о существующих коммутаторах можно получить с помощью командлета Get-CsLisSwitch . Следует помнить о том, что, несмотря на добавление записи о новом коммутаторе, данные о расположении не привязываются к нему автоматически с помощью командлета Set-CsLisPort ; расположение коммутатора устанавливается командлетом Set-CsLisSwitch .

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

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

 

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

ChassisID

Обязательный

System.String

MAC-адрес коммутатора порта. Это значение должно задаваться в форме nn-nn-nn-nn-nn-nn, например, 12-34-56-78-90-ab, или в виде IP-адреса. Если сочетание ChassisID, PortID и PortIDSubType уникально, создается новое расположение порта. Если сочетание уже существует, параметры расположения порта с этим сочетанием клавиш заменяются на значения, содержащиеся в команде.

PortID

Обязательный

System.String

ID порта привязывается к расположению.

City

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

System.String

Город, в котором расположен порт.

Максимальная длина: 64 символа.

CompanyName

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

System.String

Имя компании в данном расположении.

Максимальная длина: 60 символов

Confirm

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

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

Country

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

System.String

Страна/регион, где расположен порт.

Максимальная длина: 2 символов

Description

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

System.String

Подробное описание расположения порта.

HouseNumber

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

System.String

Номер дома, в котором находится порт. Для компании указывается номер дома по улице, где расположено здание.

Максимальная длина: 10 символов

HouseNumberSuffix

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

System.String

Дополнительные сведения о номере дома, например 1/2 или А. Например, 1234 1/2 Oak Street или 1234 A Elm Street.

Примечание. Чтобы различать номер квартиры или офиса, необходимо использовать параметр Location. Например, -Location "Suite 100/Office 150".

Максимальная длина: 5 символов

Location

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

System.String

Имя для данного расположения. Обычно это значение является более конкретным, чем городской адрес, таким как номер офиса, но может быть любым строковым значением.

Максимальная длина: 20 символов

PortIDSubType

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

Microsoft.Rtc.Management.Lis.PortIDSubType

Подтип порта. Это значение может представлять собой комбинацию цифр или строку, но при этом подтип должен быть действительным. К действительным подтипам относятся:

1: InterfaceAlias

5: InterfaceName

7: LocallyAssigned

По умолчанию: 7 (LocallyAssigned)

PostalCode

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

System.String

Почтовый индекс, связанный с данным расположением.

Максимальная длина: 10 символов

PostDirectional

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

System.String

Указание направления для названия улицы. Например, NE или NW для Main Street NE или 7th Avenue NW.

Максимальная длина: 2 символов

PreDirectional

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

System.String

Указание направления для названия улицы в начале имени улицы. Например, NE или NW для NE Main Street или NW 7th Avenue.

Максимальная длина: 2 символов

State

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

System.String

Область, республика, край или округ, связанные с данным расположением.

Максимальная длина: 2 символов

StreetName

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

System.String

Название улицы для данного расположения.

Максимальная длина: 60 символов

StreetSuffix

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

System.String

Тип улицы, указанной в имени улицы, например Street (улица), Avenue (авеню) или Court (переулок).

Максимальная длина: 10 символов

WhatIf

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

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

Принимает в качестве входных данных объекты порта LIS, переданные по конвейеру.

Этот командлет создает или изменяет объект типа System.Management.Automation.PSCustomObject.

 
Показ: