Remove-CsClientPolicy
トピックの最終更新日: 2012-03-26
既存のクライアント ポリシーを削除します。クライアント ポリシーにより、ユーザーが使用可能な Lync の機能を決定するのに役立ちます。たとえば、一部のユーザーにファイルを転送する権限を与える一方で、別のユーザーに対してはその権限を与えることを拒否できます。 UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
Remove-CsClientPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]
例
例 1
例 1 では、 Remove-CsClientPolicy コマンドレットを使用して、ID が SalesPolicy のクライアント ポリシーを削除します。
Remove-CsClientPolicy -Identity SalesPolicy
例 2
例 2 では、 Get-CsClientPolicy コマンドレットと Remove-CsClientPolicy コマンドレットを使用して、ユーザーごとのスコープで構成されているすべてのクライアント ポリシーを削除します。このコマンドは Get-CsClientPolicy コマンドレットと Filter パラメーターを使用して、ユーザーごとのスコープで構成されているすべてのクライアント ポリシーのコレクションを戻します。フィルター値 "tag:*" に基づいて、 Get-CsClientPolicy コマンドレットは、取得するデータの範囲を ID が文字列値 "tag:" で始まるクライアント ポリシーに制限します。次に、フィルター処理されたコレクションは Remove-CsClientPolicy コマンドレットにパイプ処理され、コレクション内の各ポリシーが削除されます。
Get-CsClientPolicy -Filter "tag:*" | Remove-CsClientPolicy
例 3
例 3 では、EnableAppearOffline プロパティが True に設定されているすべてのクライアント ポリシーが削除されます。これを行うため、まず追加パラメーターを指定せずに Get-CsClientPolicy コマンドレットを呼び出します。これにより、組織用に構成されているすべてのクライアント ポリシーのコレクションが戻されます。次に、このコレクションは Where-Object コマンドレットにパイプ処理され、EnableAppearOffline プロパティが True と等しいポリシーのみを選択します。このフィルター処理されたコレクションは Remove-CsClientPolicy コマンドレットにパイプ処理され、コレクション内の各ポリシーが削除されます。
Get-CsClientPolicy | Where-Object {$_.EnableAppearOffline -eq $True} | Remove-CsClientPolicy
解説
Lync Server では、クライアント ポリシーが、製品の以前のバージョンで使用されていたグループ ポリシー設定に置き換わっています。Microsoft Office Communicator 2007 および Microsoft Office Communicator 2007 R2 では、Communicator や他のクライアントでユーザーが行うことができる操作をグループ ポリシーによって決定できました。たとえば、ユーザーがインスタント メッセージング セッションのトランスクリプトを保存できるかどうか、Microsoft Outlook の情報をユーザーのプレゼンス情報に統合するかどうか、およびユーザーがインスタント メッセージに絵文字や書式付きテキストを含めることができるかどうかを決定するグループ ポリシー設定がありました。
グループ ポリシーは便利な機能ですが、 Lync Server に適用する場合、このテクノロジにはいくつかの制限があります。まず、グループ ポリシーは、ドメインごとまたは OU ごとに適用するものとして設計されており、より選抜されたユーザーのグループ (特定の部門に所属しているすべてのユーザー、特定の役職が付いたすべてのユーザーなど) をポリシーの対象とするのは困難です。また、グループ ポリシーは、ドメインにログオンするユーザーとコンピューターを使用してログオンするユーザーにのみ適用されます。グループ ポリシーは、インターネットを使って Lync Server にアクセスするユーザーや、携帯電話を使ってシステムにアクセスするユーザーには適用されません。これは、ログオンするデバイスとログオンする場所によって、同一のユーザーが異なる状況に遭遇する可能性があることを意味します。
これらの不整合に対応するために、 Lync Server はグループ ポリシーの代わりにクライアント ポリシーを使用します。ユーザーのログオン元や、ユーザーがログオンに使用するデバイスのタイプにかかわらず、クライアント ポリシーはユーザーがシステムにアクセスするたびに適用されます。さらに、クライアント ポリシーは、 Lync Server の他のポリシーと同様に、選抜したユーザーのグループに対して容易に適用できます。1 人のユーザーに割り当てるカスタム ポリシーも作成できます。
クライアント ポリシーは、グローバル、サイト、およびユーザーごとのスコープで構成できます。サイト スコープまたはユーザーごとのスコープで構成されているポリシーは、 Remove-CsClientPolicy コマンドレットを使用して後で削除できます。また、グローバル ポリシーに対して Remove-CsClientPolicy コマンドレットを実行することもできます。その場合でも、グローバル ポリシーが削除されるわけではありません。グローバル ポリシーを削除することはできないからです。ただし、グローバル ポリシーのすべてのプロパティが既定値にリセットされます。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、Remove-CsClientPolicy コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsClientPolicy"}
パラメーター
| パラメーター | 必須 | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
Microsoft.Rtc.Management.Xds.XdsIdentity |
削除するクライアント ポリシーの一意の識別子。グローバル ポリシーを "削除する" には、次の構文を使用します。-Identity global。(ただし、グローバル ポリシーを実際に削除することはできません。代わりに、そのポリシーのすべてのプロパティが既定値にリセットされます)。サイト ポリシーを削除するには、次のような構文を使用します。-Identity "site:Redmond"。ユーザー単位のポリシーを削除するには、次のような構文を使用します。-Identity "SalesDepartmentPolicy"。ポリシーの Identity を指定するときに、ワイルドカードを使用することはできません。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
Force |
省略可能 |
System.Management.Automation.SwitchParameter |
このパラメーターを指定すると、ポリシーが現在少なくとも 1 人のユーザーに割り当てられている場合でも、自動的に削除されます。このパラメーターを省略すると、少なくとも 1 人のユーザーに割り当てられているユーザーごとのポリシーが Remove-CsClientPolicy コマンドレットによって自動的に削除されることはありません。代わりに、そのポリシーを本当に削除してもよいかどうかを尋ねる確認メッセージが表示されます。コマンドを続行するには (Y キーを押して) "はい" と回答する必要があります。この結果、ポリシーが削除されます。 |
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.Client.ClientPolicy オブジェクト。 Remove-CsClientPolicy コマンドレットは、クライアント ポリシー オブジェクトのパイプラインが設定されたインスタンスを受け入れます。
戻り値の種類
Remove-CsClientPolicy コマンドレットには戻り値はありません。代わりに、Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy オブジェクトのインスタンスが削除されます。