次の方法で共有

  • [アーティクル]

Set-CsPresencePolicy

 

トピックの最終更新日: 2012-03-25

既存のプレゼンス ポリシーを変更します。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)

構文

Set-CsPresencePolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>

Set-CsPresencePolicy [-Instance <PSObject>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

例

例 1

例 1 に示すコマンドを実行すると、ユーザーごとのプレゼンス ポリシー RedmondPresencePolicy が変更されます。この例では、MaxPromptedSubscriber プロパティの値が 300 に設定されます。

Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300

例 2

例 2 に示すコマンドは、例 1 で使用したコマンドの変化形です。ただし、この例では、組織用に構成されたすべてのプレゼンス ポリシーの MaxPromptedSubscriber プロパティが 300 に設定されます。これを行うため、このコマンドはまず、パラメーターを指定せずに Get-CsPresencePolicy コマンドレットを呼び出します。これにより、組織用に構成されたすべてのプレゼンス ポリシーのコレクションが戻されます。次に、このコレクションは Set-CsPresencePolicy コマンドレットにパイプ処理され、コレクション内の各ポリシーの MaxPromptedSubscriber の値が 300 に変更されます。

Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300

例 3

例 3 は、組織のプレゼンス ポリシーを構成して、どのポリシーでも 300 より多い要求されたサブスクライバーを許可しないようにする方法を示しています。このタスクを実行するため、このコマンドはまず、パラメーターを指定せずに Get-CsPresencePolicy コマンドレットを呼び出し、組織内のすべてのプレゼンス ポリシーのコレクションを戻します。次に、このコレクションは Where-Object コマンドレットにパイプ処理され、MaxPromptedSubscriber の値が 300 より大きいポリシーのみ取得されます。フィルター処理されたコレクションは Set-CsPresencePolicy コマンドレットにパイプ処理され、コレクション内の各ポリシーが取得されて、要求されたサブスクライバーの最大数が 300 に設定されます。その結果、一部のポリシーでは 300 より少ないサブスクライバーを許可しますが、300 より多くの要求されたサブスクライバーを許可するポリシーはなくなります。

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300

解説

プレゼンス情報 (特に、連絡先がインスタント メッセージング会話に参加できるかどうかを知らせるもの) は非常に重要です。しかし同時に、プレゼンス情報に関連するコストがあります。プレゼンス サブスクリプションが増加すればするほど、プレゼンス情報の更新に当てる必要のあるネットワークの帯域幅も増加します。ネットワークの帯域幅に問題がある場合は、ユーザー当たりの保持できるプレゼンス サブスクリプションの数を制限する必要があります。

CsPresencePolicy コマンドレットを使用して、プレゼンス サブスクリプションの重要な 2 つの側面を管理できます。それは、要求されたサブスクライバーおよびカテゴリ サブスクリプションです。ユーザーが別のユーザーの Lync の連絡先リストに追加されると、既定の動作では、そのユーザーにはリストに追加されたことを知らせるポップアップ通知が表示されます。ポップアップを終了するまで、各通知は要求されたサブスクライバーと見なされます。プレゼンス ポリシーの MaxPromptedSubscriber プロパティにより、1 人のユーザーに表示できる未解決の通知ダイアログの最大数を指定できます (最大数に達した場合、少なくとも未解決のダイアログをいくつか解決するまでは、ユーザーは新しい連絡先の通知を受信できません)。

カテゴリ サブスクリプションは、予定表のデータを要求するアプリケーションなど、特定のカテゴリの情報に対する要求を表します。MaxCategorySubscription プロパティを使用して、管理者はユーザーが保持できるカテゴリ サブスクリプションの数を制限することができます。

Lync Server のリリース前は、要求されたサブスクライバーとカテゴリ サブスクリプションはグローバル ベースで管理されていました。CsPresencePolicy コマンドレットを使用して、グローバル スコープ、サイト スコープ、またはユーザーごとのスコープで、これらのプレゼンス サブスクリプションを管理できるようになりました。これにより、ユーザーがジョブの実行に必要なプレゼンス情報にアクセスできるようにしながら、同時に、帯域幅の使用を制御できます。

Set-CsPresencePolicy コマンドレットにより、組織用に構成されたすべてのプレゼンス ポリシーを変更することができます。プレゼンス ポリシーを変更するということは、単に MaxPromptedSubscriber プロパティまたは MaxCategorySubscription プロパティの値を変更することです。

このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが、Set-CsPresencePolicy コマンドレットをローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPresencePolicy"}

パラメーター

パラメーター 必須かどうか 型 説明

Confirm

省略可能

System.Management.Automation.SwitchParameter

コマンドの実行前に確認メッセージを表示します。

Description

省略可能

System.String

管理者がプレゼンス ポリシーに追加のテキストを付けられるようにします。たとえば、ポリシーを割り当てるユーザーに関する情報などを記述できます。

Force

省略可能

System.Management.Automation.SwitchParameter

コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。

Identity

省略可能

Microsoft.Rtc.Management.Xds.XdsIdentity

変更するプレゼンス ポリシーの一意の識別子。グローバル ポリシーを変更するには、次の構文を使用します。-Identity global。サイト スコープでポリシーを変更するには、次のような構文を使用します。-Identity "site:Redmond"。ユーザーごとのポリシーを変更するには、次のような構文を使用します。-Identity "RedmondPresencePolicy"。

Instance

省略可能

プレゼンス ポリシー オブジェクト

個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。

MaxCategorySubscription

省略可能

System.UInt16

任意の時点で許可されるカテゴリ サブスクリプションの最大数。カテゴリ サブスクリプションは、予定表のデータを要求するアプリケーションなど、特定のカテゴリの情報に対する要求を表します。

MaxCategorySubscription は、0 ～ 3000 の任意の整数値に設定できます。既定値は 1000 です。

MaxPromptedSubscriber

省略可能

System.UInt16

ユーザーが一度に保持できる、要求されたサブスクライバーの最大数。既定では、ユーザーが別のユーザーの連絡先リストに追加されると、そのことを知らせる通知ダイアログが表示され、その別のユーザーを自分の連絡先リストに追加したり、自分のプレゼンスをその別のユーザーが表示できないようブロックするなどの操作を行うことができます。処理を実行してダイアログ ボックスを終了するまで、各通知は要求されたサブスクライバーとみなされます。

MaxPromptedSubscriber は、0 ～ 600 の任意の整数値に設定できます。既定値は 200 です。この値を 0 に設定した場合は、ユーザーは別のユーザーの連絡先リストに追加されたときに、通知を何も受け取りません。

Tenant

省略可能

System.Guid

変更するプレゼンス ポリシーの Office 365 テナント アカウントのグローバル一意識別子 (GUID) です。次に例を示します。

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

次のコマンドを実行することにより、テナントの各々についてテナント ID を返すことができます。

Get-CsTenant | Select-Object DisplayName, TenantID

Windows PowerShell のリモート セッションを使用していて、Lync Online 15 のみに接続している場合、Tenant パラメーターを含める必要はありません。代わりに、接続情報に基づいてテナント ID が自動的に入力されます。Tenant パラメーターはハイブリッド展開で主に使用されます。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

実際にコマンドを実行せずに、コマンドの実行結果がわかります。

入力の種類

Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy オブジェクト。Set-CsPresencePolicy コマンドレットは、プレゼンス ポリシー オブジェクトのパイプ処理された入力を受け入れます。

戻り値の種類

Set-CsPresencePolicy コマンドレットを実行しても、値やオブジェクトが戻されることはありません。代わりに、Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy オブジェクトの既存のインスタンスが変更されます。