Remove-CsExUmContact
トピックの最終更新日: 2012-03-25
ホストされた Exchange ユニファイド メッセージング (UM) に対応する、自動応答またはサブスクライバー アクセスの連絡先オブジェクトを削除します。
構文
Remove-CsExUmContact -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
解説
Microsoft Lync Server 2010 は Exchange UM と連携して、自動応答やサブスクライバー アクセスなどのいくつかの音声関連の機能を提供します。Exchange UM が (社内サービスではなく) ホスト サービスとして提供されている場合は、Windows PowerShell を使用し、連絡先オブジェクトを作成して自動応答やサブスクライバー アクセスの機能を適用する必要があります。作成されたどのオブジェクトも、Remove-CsExUmContact コマンドレットで削除できます。
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーは Remove-CsExUmContact コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsExUmContact"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
UserIdParameter |
削除する連絡先オブジェクトの一意の識別子です。連絡先 ID は、以下の 4 つの形式のうちの 1 つを使用して指定できます。1) 連絡先の SIP アドレス、2) 連絡先のユーザー プリンシパル名 (UPN)、3) ドメイン\ログオン形式 (litwareinc\exum1 など) の連絡先のドメイン名とログオン名、および 4) 連絡先の Active Directory 表示名 (Team Auto Attendant など)。 完全なデータ型:Microsoft.Rtc.Management.AD.UserIdParameter |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact オブジェクト。Exchange UM 連絡先オブジェクトのパイプ処理された入力を受け入れます。
戻り値の種類
このコマンドレットを実行してもオブジェクトが戻されることはありません。Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 型のオブジェクトを削除します。
例
-------------------------- 例 1 --------------------------
Remove-CsExUmContact -Identity sip:exumsa1@fabrikam.com
この例では、SIP アドレスが exumsa1@fabrikam.com の Exchange UM 連絡先を削除します。
-------------------------- 例 2 --------------------------
Get-CsExUmContact -Filter {LineURI -like "tel:425*"} | Remove-CsExUmContact
この例では、LineURI 値が 425 で始まるすべての Exchange UM の連絡先を削除します。このコマンドの最初の部分では、Get-CsExUmContact コマンドレットを Filter パラメーターと一緒に呼び出し、フィルターとして LineURI -like "tel:425*" の式を使用します。このフィルターにより、ワイルドカード文字列 425\* に一致する LineURI を持つ Exchange UM の連絡先オブジェクトの取得が指示されます。つまり、文字列 425 で始まり、一連の任意の文字で終わるすべての回線 URI が取得されます。このオブジェクトのコレクションを取得したら、Remove-CsExUmContact コマンドレットにパイプ処理します。これにより、コレクション内のすべての項目が削除されます。