Get-CsVoicePolicy
上一次修改主题： 2012-03-23
返回有关为组织配置的一个或多个语音策略的信息。
语法
Get-CsVoicePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoicePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
此 cmdlet 可检索语音策略信息。语音策略用于管理诸如同时响铃（每次有人拨打办公电话时可以同时使第二部电话响铃的功能）和呼叫转接等企业语音相关功能。使用此 cmdlet 可检索启用和禁用这些功能中的许多功能的设置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsVoicePolicy cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsVoicePolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
用于指定策略作用域（某些情况下是策略名称）的唯一标识符。如果省略该参数，将返回组织的所有语音策略。 |
Filter |
可选 |
字符串 |
此参数接受通配符字符串，并返回标识与该字符串匹配的所有语音策略。例如，Filter 值为“site:*”时将返回在站点级别定义的所有语音策略。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索语音策略。 |
输入类型
无。
返回类型
此 cmdlet 返回 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 来检索所有用户语音策略。