Remove-CsAnnouncement
トピックの最終更新日: 2012-03-26
Microsoft Lync Server 2010 の既存のアナウンスを削除します。アナウンスは、有効だが割り当てられていない電話番号をユーザーがダイヤルしたときに再生されるものです。アナウンスは、メッセージ (たとえば、"This number is temporarily out of service" (この番号は現在使用されていません)) の場合とビジー シグナルの場合があります。
構文
Remove-CsAnnouncement -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
解説
組織で保有している電話番号の中には、ユーザーや電話機に割り当てられていないものがある場合があります。しかし、これらも有効な番号であるため、呼び出しを受ける可能性があります。既定では、こういった番号のいずれかをダイヤルしたユーザーにはビジー シグナルが聞こえ、SIP クライアントへは通話のエラーが返される場合があります。割り当てられていない番号にアナウンス設定を適用すると、管理者はメッセージの再生、ビジー シグナルの送信、または呼び出しのリダイレクトというオプションを選択できるようになります。このコマンドレットは、これらのアナウンス設定を 1 つ以上削除します。
割り当てられていない番号範囲に関連するアナウンスを削除しようとすると、既定では、そのアナウンスを本当に削除するかを確認するプロンプトが表示されます。アナウンスを削除するとその範囲の AnnouncementName プロパティの表示は Null になり、その範囲内の番号に着信した際アナウンスは再生されず、ビジー シグナルが聞こえるだけになります。ただし、AnnouncementId プロパティの値 (削除されたアナウンスの GUID) はそのまま見ることができます。
このコマンドレットを実行できるユーザー: 既定では、Remove-CsAnnouncement コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAnnouncement"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsIdentity |
削除するアナウンスの一意の識別子。Identity パラメーターの値は、2 つの方法のいずれかで指定できます。 - 削除するアナウンスに対応する アプリケーション サービス の Identity を入力します。この場合、指定したサービスの Identity で構成されたすべてのアナウンスが削除されます。次に例を示します。ApplicationServer:Redmond.litwareinc.com - 削除する単一のアナウンスに対応する完全な Identity を入力します。この値は常に <serviceID>/<GUID> という形式にします。serviceID はアナウンス サービスを実行するアプリケーション サーバーの ID、GUID はこのアナウンスに割り当てられた一意のグローバル識別子です。次に例を示します。ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。
戻り値の種類
Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement オブジェクトの既存のインスタンスを削除します。
例
-------------------------- 例 1 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"
上のコマンドを実行すると、"ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90" という ID を持つアナウンスが削除されます。ID は一意である必要があるため、このコマンドが削除するアナウンスは最大でも 1 つです。
-------------------------- 例 2 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com"
例 2 では、ApplicationServer:Redmond.litwareinc.com というサービスに適用されているすべてのアナウンスが削除されます。この処理を行うため、Remove-CsAnnouncement に Identity パラメーターを指定して呼び出しています。"ApplicationServer:Redmond.litwareinc.com" というパラメーター値を指定する (特定のアナウンスを識別する GUID を追加指定しない) と、指定したサービスに構成されているすべてのアナウンスが削除されます。