Get-CsPstnUsage
上一次修改主题： 2012-03-23
返回在组织中使用的公用电话交换网 (PSTN) 用法记录的信息。
语法
Get-CsPstnUsage [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPstnUsage [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
PSTN 用法是用于呼叫授权的字符串值。PSTN 用法将语音策略链接至路由。Get-CsPstnUsage cmdlet 可检索组织内所有可用 PSTN 用法的列表。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsPstnUsage cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPstnUsage"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
这些设置的应用级别。可应用于 PSTN 用法的唯一标识是 Global。 |
Filter |
可选 |
字符串 |
Filter 参数允许只检索那些 Identity 与特定通配符字符串匹配的 PSTN 用法。但是，由于 PSTN 用法的唯一 Identity 是 Global，因此此参数对此 cmdlet 没有用处。 |
LocalStore |
可选 |
开关参数 |
从本地数据存储而不是主中央管理存储检索 PSTN 用法信息。 |
输入类型
无。
返回类型
Get-CsPstnUsage 返回 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PSTNUsages 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsPstnUsage
此命令返回组织内可用的全局 PSTN 用法的列表。
-------------------------- 示例 2 --------------------------
(Get-CsPstnUsage).Usage
此示例中的命令返回所有已定义 PSTN 用法的列表，输出的每一行列出一个用法。调用 Get-CsPstnUsage 本身将返回 Identity 和用法列表。如果用法列表包含三个或四个以上的条目，则会在输出中缩减该列表，如下所示：
Usage :{Internal, Local, Long Distance, International...}
使用此示例中的命令将仅显示用法列表。输出如下所示：
Internal
Local
Long Distance
International
Restricted
-------------------------- 示例 3 --------------------------
(Get-CsPstnUsage).Usage | ForEach-Object {if ($_ -like "*tern*") {$_}}
此命令返回名称中包含字符串“tern”的所有 PSTN 用法名称。例如，此命令将返回“Internal”和“International”，但不返回“Local”或“Long Distance”。
此命令的第一部分是括在括号中的 Get-CsPstnUsage cmdlet，它表示首先采取的操作用于要检索的所有 PSTN 用法。属性 .Usage 仅返回 PSTN 用法的用法信息，而不是 Identity。然后，将该用法列表通过管道传递到 ForEach-Object cmdlet，该 cmdlet 每次处理一个用法字符串。If 语句将当前用法字符串与字符串“*tern*”（* 是通配符）进行比较，并显示任何与该模式匹配的用法字符串。