Get-CsVoicePolicy
上次修改主題的時間： 2012-03-23
傳回組織已設定之一或多個語音原則的相關資訊。
語法
Get-CsVoicePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoicePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
此指令程式會擷取語音原則資訊。語音原則可用來管理 Enterprise Voice 相關功能，例如同時響鈴 (每次有人撥打到您的辦公室電話時，能夠讓第二支電話響起) 和來電轉接。請使用此指令程式來擷取設定，以啟用和停用其中的許多功能。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsVoicePolicy Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsVoicePolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
指定原則的範圍和 (在某些情況下) 名稱的唯一識別碼。如果省略此參數，則會傳回組織的所有語音原則。 |
Filter |
選用 |
字串 |
此參數接受萬用字元字串，並傳回識別符合該字串的所有語音原則。例如，Filter 值為 site:* 會傳回網站層級上定義的所有語音原則。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取語音原則，而不是從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
此指令程式會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsVoicePolicy
此範例會顯示組織已定義的所有語音原則和每一個語音原則的設定。
-------------------------- 範例 2 --------------------------
Get-CsVoicePolicy -Identity UserPolicy1
此範例會使用 Identity 參數來擷取名為 UserPolicy1 之個別使用者原則的語音原則設定。
-------------------------- 範例 3 --------------------------
Get-CsVoicePolicy -Filter tag*
此範例會使用 Filter 參數來擷取可指派給使用者的所有語音原則設定。所有使用者語音原則都具有 tag:<UserVoicePolicy> 格式的 Identity，因此我們篩選 tag 來擷取所有使用者語音原則。