次の方法で共有


Remove-CsArchivingConfiguration

 

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

指定したアーカイブ設定のコレクションを削除します。アーカイブ設定を使用して、インスタント メッセージング (IM) セッションの自動保存を有効化または無効化し、オプションで、アーカイブできないすべてのインスタント メッセージをブロックします。

構文

Remove-CsArchivingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

解説

多くの組織では、自社のユーザーが参加するすべての IM セッションと会議のトランスクリプト (コピー) を保持すると役に立つことに気が付いています。他の組織にとっては、そのようなトランスクリプトを保持することは必須です。たとえば、金融業界の多くの組織では、自社のすべての電子コミュニケーションのコピーを保持することが法令によって要求されています。

Microsoft Lync Server 2010 では、IM および Web 会議セッションのアーカイブを柔軟に行うことができます。アーカイブ サーバー を既に展開した場合は、さまざまな CsArchivingConfiguration コマンドレットを使用して IM セッションのアーカイブを有効化および無効化し、アーカイブ データベースを管理することができます。また、アーカイブが失敗した場合に IM を中断することもできます。この結果、すべての電子コミュニケーションの記録が確実に保持されるようになります。

Lync Server 2010 をインストールするときに、グローバル アーカイブ設定のコレクションが作成されます。既定では、これらの設定は組織全体に適用されます。または、New-CsArchivingConfiguration コマンドレットを使用して、カスタムの構成設定をサイトごとに作成できます。New-CsArchivingConfiguration を使用して作成したサイト固有の設定は、後で Remove-CsArchivingConfiguration コマンドレットを使用して削除できます。サイトに対する設定を削除する場合、影響を受けるサイトは、その後、グローバル設定によって制御されます。

Remove-CsArchivingConfiguration は、グローバル アーカイブ設定に対しても実行できることに注意してください。ただし、その場合は、設定は削除されません。グローバル設定を削除することはできないからです。代わりに、すべてのグローバル プロパティは既定値にリセットされます。たとえば、グローバル スコープで IM セッションのアーカイブを有効にしているとします。後で、Remove-CsArchivingConfiguration -Identity global コマンドを実行します。このコマンドを実行すると、グローバル設定に関するプロパティ値はリセットされます。これは、EnableArchiving が既定値の None に戻ることを意味します。その結果、グローバル スコープでアーカイブは無効になります。

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsArchivingConfiguration"}

パラメーター

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

Identity

必須

Xds Identity

削除するアーカイブ設定のコレクションに対応する一意の識別子です。グローバル コレクションを削除するには、次の構文を使用します。-Identity global (グローバル設定を実際に削除することはできない点に注意してください。代わりに実行できるのは、プロパティを既定値にリセットすることのみです)。サイト コレクションを削除するには、次のような構文を使用します。-Identity site:Redmond。ポリシーの Identity を指定するときに、ワイルドカードを使用することはできません。

Force

省略可能

スイッチ パラメーター

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

WhatIf

省略可能

スイッチ パラメーター

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

Confirm

省略可能

スイッチ パラメーター

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

入力の種類

Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings オブジェクト。Remove-CsArchivingConfiguration accepts は、アーカイブ構成オブジェクトに関する、パイプ処理された入力を受け入れます。

戻り値の種類

Set-CsArchivingConfiguration は、値またはオブジェクトを戻しません。代わりに Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings オブジェクトのインスタンスが削除されます。

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

Remove-CsArchivingConfiguration -Identity site:Redmond

上記の例では、Remove-CsArchivingConfiguration を使用して、site:Redmond という Identity を持つアーカイブの構成設定を削除します。

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

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

例 2 のコマンドでは、サイト スコープで既に構成されたすべてのアーカイブの構成設定が削除されます。これを実行するため、まず Get-CsArchivingConfiguration および Filter パラメーターを使用してサイト スコープにあるすべての構成設定のコレクションを戻しています。これを実行するには、フィルター値 "site:*" を使用します。これは、Identity が "site:" という文字で始まる設定に関するデータを戻すように制限を加えます。次に、フィルターしたコレクションを Remove-CsArchivingConfiguration にパイプ処理し、コレクション内の各項目を削除します。

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

Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "None"} | Remove-CsArchivingConfiguration

例 3 では、EnableArchiving プロパティが既に "None" に設定されていたすべてのアーカイブの構成設定を削除します。このタスクを実行するには、最初にパラメーターなしで Get-CsArchivingConfiguration を呼び出します。この結果、組織で使用するために構成されているすべてのアーカイブ設定のコレクションが戻されます。このコレクションが Where-Object コマンドレットにパイプ処理されます。これは、EnableArchiving プロパティが "None" に等しい設定のみを選択します。次に、フィルターしたコレクションを Remove-CsArchivingConfiguration にパイプ処理し、コレクション内の各項目を削除します。