Set-CsLisPort
上一次修改主题： 2012-03-26
创建位置信息服务器 (LIS) 端口，在端口和位置（如果该位置不存在，就创建一个新位置）之间创建关联，或修改现有端口和与其关联的位置。在增强型 911 (E9-1-1) 企业语音实施过程中，端口和位置间的关联可用于向紧急服务操作员报告呼叫者的位置。
语法
Set-CsLisPort -ChassisID <String> -PortID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-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>] [-WhatIf [<SwitchParameter>]]
Set-CsLisPort -ChassisID <String> -PortID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-WhatIf [<SwitchParameter>]]
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> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
详细说明
通过增强型 9-1-1，紧急接线员不必向呼叫者询问其位置即可确定该信息。当呼叫者通过 IP 电话 (VoIP) 连接进行呼叫时，必须根据各种连接因素提取该信息。VoIP 管理员必须配置用于确定呼叫者位置的位置映射（称为 wiremap）。使用此 cmdlet，管理员可以将物理位置映射到客户端连接通过的端口。
ChassisID、PortID 和 PortIDSubType 的组合构成了一个唯一的端口位置。如果输入已存在的 ChassisID/PortID/PortIDSubType 密钥组合，此 cmdlet 将根据所提供的位置参数来更新该端口的位置。如果密钥组合不存在，则会创建新的端口位置。
如果位置数据库中不存在地址与在此处输入的地址参数（包括空值）完全匹配的位置，则将根据输入的参数，使用此 cmdlet 来创建新地址（可以通过调用 Get-CsLisLocation cmdlet 检索位置列表。）Set-CsLisPort 不需要或不提示输入位置参数，因此在创建端口项时无需将其与位置关联。此外，使用此 cmdlet 可能会创建无效的位置。有效位置至少需包含 Location、HouseNumber、StreetName、City、State 以及 Country。如果不提供所有这些参数，引用端口收到的呼叫可能不包含紧急操作员需要的信息，具体取决于有效设置是否适用于可替换端口设置的开关、子网或无线访问点。建议尽量使用具体的位置参数，并填写尽可能多的参数。
此 cmdlet 需要的参数之一为 ChassisID。ChassisID 是端口网络交换机的媒体访问控制 (MAC) 地址。如果位置数据库中不存在此交换机，则此 cmdlet 将创建该交换机。可以通过调用 Get-CsLisSwitch cmdlet 来检索现有交换机。请记住，虽然将创建新的交换机项，但是该交换机不会自动与使用 Set-CsLisPort cmdlet 输入的位置信息关联；必须使用 Set-CsLisSwitch cmdlet 设置交换机位置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsLisPort cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisPort"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
ChassisID |
必需 |
字符串 |
端口交换机的 MAC 地址。此值必须采用 nn-nn-nn-nn-nn-nn 的格式，如 12-34-56-78-90-ab 或 IP 地址。如果 ChassisID、PortID 和 PortIDSubType 的组合是唯一的，则将创建新的端口位置。如果此组合不是唯一的，则将使用命令提供的参数值更新具有该密钥组合的端口位置。 |
City |
必需 |
字符串 |
此端口所在的城市。 最大长度：64 个字符。 |
CompanyName |
必需 |
字符串 |
位于此位置的公司的名称。 最大长度：60 个字符 |
Country |
必需 |
字符串 |
此端口所在的国家/地区。 最大长度：两个字符 |
Description |
可选 |
字符串 |
此端口位置的详细描述。 |
HouseNumber |
必需 |
字符串 |
端口位置的门牌号。对于公司，这是该公司所在位置的街道号。 最大长度：10 个字符 |
HouseNumberSuffix |
必需 |
字符串 |
门牌号的附加信息，如 1/2 或 A。例如，1234 1/2 Oak Street 或 1234 A Elm Street。 注意：要指定房间号或办公套房，必须使用 Location 参数。例如，-Location "Suite 100/Office 150"。 最大长度：5 个字符 |
Location |
必需 |
字符串 |
此位置的名称。此值通常是比普通地址更加具体的某个位置（如办公室号码）的名称，但它可以是任何字符串值。 最大长度：20 个字符 |
PortID |
必需 |
字符串 |
与此位置关联的端口 ID。 |
PortIDSubType |
可选 |
端口 ID 子类型 |
端口的子类型。此值可以数字值或字符串的形式输入，但必须是有效的子类型。有效的子类型是： 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned 默认值：7 (LocallyAssigned) |
PostalCode |
必需 |
字符串 |
与此位置关联的邮政编码。 最大长度：10 个字符 |
PostDirectional |
必需 |
字符串 |
街道名称的方向指定。例如，用于主街 NE 和第七大街 NW 的 NE 或 NW。 最大长度：两个字符 |
PreDirectional |
必需 |
字符串 |
街道名称的方向指定，位于街道名称之前。例如，NE 或 NW 分别代表 NE Main Street 或 NW 7th Avenue。 最大长度：两个字符 |
State |
必需 |
字符串 |
与此位置关联的州或省。 最大长度：两个字符 |
StreetName |
必需 |
字符串 |
此位置所在街道的名称。 最大长度：60 个字符 |
StreetSuffix |
必需 |
字符串 |
在街道名称中指定的街道类型，例如，街道、大街或庭院。 最大长度：10 个字符 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
接受通过管道传递的 LIS 端口对象的输入。
返回类型
此 cmdlet 可创建或修改类型为 System.Management.Automation.PSCustomObject 的对象。
示例
-------------------------- 示例 1 --------------------------
Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
示例 1 将创建或更新 LIS 端口位置项。此示例中的命令包括三个参数：ChassisID、PortID 和 PortIDSubtype。ChassisID 的值是 MAC 地址 99-99-99-99-99-99，PortID 的值为 4200，且 PortIDSubType 的值为 1（请注意，PortIDSubType 的一个为 1 的值可转换为 InterfaceAlias 的值。此参数和值还可以按此方式输入：-PortIDSubType InterfaceAlias.)创建端口位置的唯一实例时，需要这三个参数。
请注意，此示例不包含任何地址信息。可以在位置信息服务器上创建一个端口项，且无须将其与地址关联。但是，通过此端口路由的紧急呼叫包含的信息可能不足，因此紧急操作员无法识别某个位置，具体取决于已定义的子网或交换机的位置。
重要说明：如果具有此密钥组合的 LIS 端口位置已经存在，则该端口位置将替换为此命令中的值。这就意味着，如果此端口已与某个地址（物理位置）关联，则该关联将不再存在，因为此命令中未包括任何位置信息。该位置仍会存在于位置数据库中，但不会与此端口关联。
-------------------------- 示例 2 --------------------------
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
示例 2 通过添加地址信息更新在示例 1 中创建的端口。如果位置数据库中不存在此地址，则此 cmdlet 将创建该位置。
-------------------------- 示例 3 --------------------------
$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
对于 MAC 地址 (ChassisID) 为 99-99-99-99-99-88 的端口，本示例将更新为其定义的所有位置。本示例中的第一行以 Get-CsLisPort 调用开始，通过此调用，可以检索已在 LIS 服务中定义的全部端口。将该端口集合通过管道传递到 Where-Object cmdlet，借此可以找到 ChassisID 等于 (-eq) 99-99-99-99-99-88 的集合中的所有项。ChassisID 为 99-99-99-99-99-88 的端口集合已分配给变量 $a。
在此示例的第二行中，我们将变量 $a 的内容（ChassisID 为 99-99-99-99-99-88 的 LIS 端口集合）传递到 Set-CsLisPort cmdlet。此 cmdlet 可将所有项目都包括在该集合中，并使用指定参数（Location、HouseNumber、StreetName、StreetSuffix、City、State、Country 以及 PostalCode）中的值更新每个项目。