Set-CsHostedVoicemailPolicy
上次修改主題的時間： 2012-03-26
修改主控的語音信箱原則。
語法
Set-CsHostedVoicemailPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Set-CsHostedVoicemailPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式會修改原則來設定已啟用 Microsoft Lync Server 2010 或 Microsoft Office Communications Server 的使用者帳戶使用 Exchange Unified Messaging (UM) 主控的語音信箱服務。此原則決定如何將使用者未接聽的來電轉接至主控的 Exchange UM 服務。
使用者必須已啟用 Exchange UM 主控的語音信箱，此原則才會生效。您可以呼叫 Get-CsUser 指令程式並檢查 HostedVoiceMail 屬性，以判斷使用者是否已啟用主控的語音信箱(值為 True 表示使用者已啟用)。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsHostedVoicemailPolicy Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsHostedVoicemailPolicy"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
字串 |
您要修改之主控語音信箱原則的唯一識別碼。這個 Identifier 包括範圍 (若是通用)、範圍和網站 (指網站原則，例如 site:Redmond) 或原則名稱 (指個別使用者原則，例如 HVUserPolicy)。 |
Instance |
選用 |
主控的語音信箱原則 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 物件的類型必須是 HostedVoicemailPolicy，而且可以透過呼叫 Get-CsHostedVoicemailPolicy 指令程式來擷取。 |
Description |
選用 |
字串 |
原則的簡易描述。 |
Destination |
選用 |
字串 |
指派給此參數的值是主控的 Exchange UM 服務的完整網域名稱 (FQDN)。 如果您嘗試為主控的語音信箱啟用使用者，而為該使用者指派的原則沒有 Destination 值，則啟用將會失敗。 此值必須有 255 個字元或更少，且格式必須符合規則運算式字串 ^[a-zA-Z0-9\-_]+(\.[a-zA-Z0-9\-_]+){0,}$。這只是表示它應該為 FQDN 的格式，例如 server.litwareinc.com。 |
Organization |
選用 |
字串 |
此參數包含 Exchange 承租人 (含 Lync Server 2010 使用者) 的逗號分隔清單。必須以主控的 Exchange 服務上的承租人的 FQDN 來指定每一個承租人。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy 物件。接受管線傳送的主控語音信箱原則物件輸入。
傳回類型
此指令程式會修改 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy 類型的物件
範例
-------------------------- 範例 1 --------------------------
Set-CsHostedVoicemailPolicy -Identity ExRedmond -Destination ExUM.contoso.com
此命令會修改主控的語音信箱原則 ExRedmond 的 Destination 屬性。它會將此原則的 Exchange UM 目的地設定在 FQDN ExUM.contoso.com。
-------------------------- 範例 2 --------------------------
$a = (Get-CsHostedVoicemailPolicy -Identity ExRedmond).Organization
$a += ",corp3.litwareinc.com"
Set-CsHostedVoicemailPolicy -Identity ExRedmond -Organization $a
此命令會將 Exchange 承租人新增至 ExRedmond 原則的承租人 (組織) 逗號分隔清單。第一行會呼叫 Get-CsHostedVoicemailPolicy，以 Identity ExRedmond 來擷取原則。此指令程式呼叫會以括弧括住，因為我們需要先擷取此原則。接著，我們使用「點標記法」來擷取原則的 Organization 屬性。我們將傳回的字串以變數 $a 儲存。下一行會使用 += 運算子，將指派的字串 (,corp3.litwareinc.com) 附加以 $a 變數儲存的字串尾端 (請注意指派字串中的逗號。Organization 是逗號分隔清單，因此若清單中已經有值，則其他任何值的前面都必須加上逗號)。最後，在最後一行中，我們呼叫 Set-CsHostedVoicemailPolicy，並將 $a 變數傳遞給 Organization 參數，以指派新的 Organization 字串。