Get-CsPstnUsage
上次修改主題的時間： 2012-03-23
傳回關於組織中使用之公用交換電話網路 (PSTN) 使用方式記錄的資訊。
語法
Get-CsPstnUsage [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPstnUsage [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
PSTN 使用方式是用於電話授權的字串值。PSTN 使用方式會將語音原則連結至路由。Get-CsPstnUsage 指令程式會擷取組織內可用的所有 PSTN 使用方式清單。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsPstnUsage Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPstnUsage"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
套用這些設定的層級。唯一可以套用至 PSTN 使用方式的 Identity 是 Global。 |
Filter |
選用 |
字串 |
Filter 參數允許您只擷取 Identity 符合特定萬用字元字串的 PSTN 使用方式。不過，PSTN 使用方式唯一可用的 Identity 是 Global，因此這個參數對此指令程式沒有作用。 |
LocalStore |
選用 |
切換參數 |
從本機資料存放區擷取 PSTN 使用方式資訊，而不是從主要的 中央管理存放區 擷取。 |
輸入類型
無。
傳回類型
Get-CsPstnUsage 會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PSTNUsages 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsPstnUsage
這個命令會傳回組織內可用的通用 PSTN 使用方式清單。
-------------------------- 範例 2 --------------------------
(Get-CsPstnUsage).Usage
此範例中的命令會傳回所有已定義之 PSTN 使用方式的清單，並且在輸出的每一行列出一個使用方式。單獨呼叫 Get-CsPstnUsage 會傳回 Identity 及 Usage 清單。如果 Usage 清單包含三個或四個以上的項目，清單將會在輸出中縮短，類似如下所示：
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 指令程式，這表示最先進行的動作是擷取所有的 PSTN 使用方式。.Usage 屬性只會傳回 PSTN 使用方式的使用方式資訊，而不會傳回 Identity。這份使用方式清單接著會傳送至 ForEach-Object 指令程式，它會一次查看一個使用方式字串。If 陳述式會比對目前的使用方式字串以及字串 "*tern*" (* 為萬用字元)，然後顯示符合該模式的任何出現項目。