Remove-CsPushNotificationConfiguration

 

トピックの最終更新日: 2012-04-23

既存のプッシュ通知構成設定のコレクションを削除します。プッシュ通知サービス (Apple Push Notification Service および Microsoft Lync Server 2010 Push Notification Service) は、新しいインスタント メッセージ、新しいボイス メールなどのイベントに関する通知を、iPhone、Windows Phone などのモバイル デバイスに送信する手段を提供します。こうしたイベントに関する通知は、これらのデバイスで Microsoft Lync 2010 アプリケーションが一時停止している場合、またはバックグラウンドで実行されている場合でも送信されます。

構文

Remove-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

解説

Apple Push Notification Service と Microsoft Lync Server 2010 Push Notification Service を使用すれば、Apple iPhone あるいは Windows Phone で Lync 2010 を実行中のユーザーは、Lync 2010 が一時停止しているか、あるいはバックグラウンドで実行中でも、Lync 2010 イベントの通知を受信できます。たとえば、ユーザーは以下のようなイベントの通知を受信できます。

- 新しいインスタント メッセージング セッションあるいは会議への招待

- 新しいインスタント メッセージ

- 新しいボイス メール

プッシュ通知サービスがない場合は、Lync 2010 がフォアグラウンドでアクティブなアプリケーションとして実行中のときだけ、ユーザーはこれらの通知を受信します。

管理者は、iPhone ユーザーあるいは Windows Phone ユーザー、もしくはその両方に対して、プッシュ通知の有効と無効を切り替えることができます (既定では、プッシュ通知は、iPhone ユーザーと Windows Phone ユーザーの両方に対して無効です)。管理者は、Set-CsPushNotificationConfiguration コマンドレットを使用して、グローバル スコープでプッシュ通知の有効と無効を切り替えることができます。また、New-CsPushNotificationConfiguration コマンドレットを使用して、サイト スコープでカスタムのプッシュ通知設定を作成できます。

これらのカスタム設定は、Remove-CsPushNotificationConfiguration コマンドレットを使用して後で削除できます。サイト スコープで構成されている設定を削除すると、そのサイトのユーザーは、グローバル プッシュ通知設定で自動的に管理されるようになります。

Remove-CsPushNotificationConfiguration コマンドは、グローバル設定に対して実行できることにも注意してください。ただし、実行しても、グローバル設定は削除されません。代わりに、グローバル コレクションのプロパティすべてが既定値にリセットされるだけです。この場合、Apple Push Notification Service および Microsoft Lync Server 2010 Push Notification Service の両方からプッシュ通知が無効になることを意味します。

このコマンドレットを実行できるユーザー: 既定では、Remove-CsPushNotificationConfiguration コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。

パラメーター

パラメーター	必須かどうか	型	説明
Identity	必須	XdsIdentity	削除するプッシュ通知構成設定のコレクションの一意の識別子。グローバル コレクションを削除するには、次の構文を使用します。 -Identity global グローバル設定を実際に削除することはできません。代わりに、プロパティが既定値にリセットされるだけです。 サイト コレクションを削除するには、次のような構文を使用します。 -Identity site:Redmond ポリシーの Identity を指定するときに、ワイルドカードを使用することはできません。
Force	省略可能	スイッチ パラメーター	コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージが表示されないようにします。
Tenant	省略可能	GUID	このパラメーターは、Microsoft Office 365 で使用する目的で予約されています。
WhatIf	省略可能	スイッチ パラメーター	実際にコマンドを実行せずに、コマンドの実行結果がわかります。
Confirm	省略可能	スイッチ パラメーター	コマンドの実行前に確認メッセージを表示します。

入力の種類

Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration。Remove-CsPushNotificationConfiguration は、PushNotificationConfiguration オブジェクトのパイプ処理されたインスタンスを受け入れます。

戻り値の種類

なし。代わりに、Remove-CsPushNotificationConfiguration は、Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration オブジェクトのインスタンスを削除します。

例

-------------------------- 例 1 --------------------------

Remove-CsPushNotificationConfiguration -Identity "site:Redmond"

例 1 に示すコマンドは、Redmond サイトに割り当てられたプッシュ通知設定のコレクションを削除します。

-------------------------- 例 2 --------------------------

Get-CsPushNotificationConfiguration -Filter "site:*" | Remove-CsPushNotificationConfiguration

上記のコマンドは、サイト スコープで構成されているすべてのプッシュ通知設定を削除します。このタスクを実行するため、まず、Get-CsPushNotificationConfiguration コマンドレットと Filter パラメーターを使用して、サイト スコープで構成されているすべての設定のコレクションを戻します。フィルター値 "site:*" により、戻される項目は、文字列値 "site:" で始まる ID を持つ設定に制限されます。次に、サイト スコープの設定を Remove-CsPushNotificationConfiguration コマンドレットにパイプ処理し、削除します。

-------------------------- 例 3 --------------------------

Get-CsPushNotificationConfiguration | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Remove-CsPushNotificationConfiguration

例 3 は、Microsoft Lync Server 2010 Push Notification Service からプッシュ通知が無効になっているすべてのプッシュ通知構成設定を削除する方法を示しています。これを行うため、まず、Get-CsPushNotificationConfiguration を使用して、現在使用されているすべてのプッシュ通知設定のコレクションを戻します。次に、このコレクションを Where-Object コマンドレットにパイプ処理し、EnableMicrosoftPushNotificationService プロパティが False に等しい (-eq) 設定のみを選択します。そして、このフィルターされたコレクションを Remove-CsPushNotificationConfiguration にパイプ処理し、コレクション内の各項目を削除します。