Set-CsPstnUsage
上次修改主題的時間: 2012-03-25
修改一組可識別允許之公用交換電話網路 (PSTN) 使用方式的字串。此指令程式可用來將使用方式新增至 PSTN 使用方式清單,或從清單中移除使用方式。
語法
Set-CsPstnUsage [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsPstnUsage [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Usage <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
PSTN 使用方式是用於電話授權的字串值。PSTN 使用方式會將語音原則連結至路由。Set-CsPstnUsage 指令程式可用來在使用方式清單中新增或移除電話使用方式。此為通用清單,因此可供整個 Microsoft Lync Server 2010 部署中的原則和路由使用。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Set-CsPstnUsage Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPstnUsage"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
選用 |
XdsIdentity |
套用這些設定的範圍。此指令程式的 Identity 一律是 Global。 |
Instance |
選用 |
PstnUsages |
PSTN 使用方式物件的參照。此物件的類型必須是 PstnUsages,而且可呼叫 Get-CsPstnUsage 來擷取此物件。 |
Usage |
選用 |
PSListModifier |
包含可允許的使用方式字串清單。這些項目可以是任何字串值。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages 物件。接受 PSTN 使用方式物件的管線傳送資料。
傳回類型
這個指令程式不會傳回值或物件。而是會設定 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnUsages 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsPstnUsage -Identity global -Usage @{add="International"}
此命令會將 "International" 字串新增至目前可用的 PSTN 使用方式清單。
-------------------------- 範例 2 --------------------------
Set-CsPstnUsage -Identity global -Usage @{remove="Local"}
此命令會從可用的 PSTN 使用方式清單中移除 "Local" 字串。
-------------------------- 範例 3 --------------------------
Set-CsPstnUsage -Usage @{remove="Local"}
此範例的命令所執行的動作與範例 2 的完全相同:它會移除 "Local" PSTN 使用方式。此範例會顯示未指定 Identity 參數的命令。Set-CsPstnUsage 指令程式唯一可用的 Identity 是 Global 識別身分;省略 Identity 參數預設會使用 Global。
-------------------------- 範例 4 --------------------------
Set-CsPstnUsage -Usage @{replace="International","Restricted"}
此命令以 International 和 Restricted 值取代使用方式清單中的所有項目。移除先前存在的所有使用方式。