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 にパイプ処理し、コレクション内の各項目を削除します。