<book_title> を検索 ...

Enterprise Vault™ PowerShell Cmdlets

Last Published: 2024-03-04

Product(s): Enterprise Vault (15.0)

Set-EVArchive

Set-EVArchive は、ユーザーがアーカイブのアイテムを手動で削除できるかどうか、Enterprise Vault が保持期間が切れたアーカイブ済みアイテムを自動的に削除できるかどうかなど、処理対象アーカイブのさまざまなプロパティを設定できます。管理コンソールで表示するアーカイブの説明と管理用のメモを指定することもできます。アーカイブに適用する保持計画を指定することもできます。-RetentionPlanName の値を空の文字列で指定すると、Set-EVArchive はアーカイブから既存の保持計画を削除します。

Set-EVArchive は、スナップイン Symantec.EnterpriseVault.PowerShell.Snapin.dll によって提供されます。

構文

Set-EVArchive [[-ArchiveID] <String>] [-DeleteProtected [<Boolean>]] [-DeleteExpiredItems [<Boolean>]] [-Description [<String>]] [-AdminNote [<String>]] [-RetentionPlanName [<String>]] [-Force [<Boolean>]] [<CommonParameters>]

パラメータ

表: Set-EVArchive パラメータ

パラメータ	説明
-ArchiveID (必須)	プロパティを設定するアーカイブの ID を指定します。必要な ID は Get-EVArchive cmdlet を使って取得できます。
-DeleteProtected	ユーザーがアーカイブのアイテムを手動で削除できるようにするかどうかを指定します。ユーザーによるアイテムの削除を許可するには $false に設定します。削除を許可しない場合は $true に設定します。
-DeleteExpiredItem	保持期間の期限切れ後に、Enterprise Vault にアーカイブ済みアイテムの自動削除を許可するかどうかを指定します。Enterprise Vault による期限切れアイテムの削除を許可しない場合は $false に設定します。削除を許可する場合は $true に設定します。
-Description	管理コンソールのアーカイブプロパティで表示される短い説明を提供します。
-AdminNote	管理コンソールのアーカイブプロパティで表示される管理用のメモを提供します。
-RetentionPlanName	アーカイブに適用する保持計画の名前を指定します。アーカイブが他のアーカイブに関連付けられている 1 つ以上のターゲットに関連付けられている場合、このコマンドは影響を受けるすべてのアーカイブの保持計画を更新します。-RetentionPlanName の値を空の文字列で指定すると、Set-EVArchive はアーカイブから既存の保持計画を削除します。 Exchange やインターネットメールアーカイブで、Set-EVArchive は、保持計画で定義した保持フォルダを作成または更新します。Cmdlet はまずアーカイブの使用する言語を判断し、この言語で保持フォルダ名を指定した場合は、それに応じてフォルダに名前を付けます。使用する言語が Enterprise Vault でサポートされていない場合、または Enterprise Vault で言語がサポートされているがそこにフォルダ名を指定していない場合、Enterprise Vault のデフォルト言語のフォルダ名が使用されます。アーカイブタスクが次にメールボックスの同期を実行するときに、指定した保持計画を適切なプロビジョニンググループの保持設定で上書きする場合があることに注意してください。
-Force	確認メッセージを表示することなく、-RetentionPlanName で指定される保持計画を適用します。

例

Set-EVArchive 14B...EVSERVER.LOCAL -DeleteProtected:$true -DeleteExpiredItems:$false
ユーザーと Enterprise Vault による処理対象アーカイブのアイテムの削除を停止して、そのアーカイブをリーガルホールドの状態に設定します。
Set-EVArchive 14B...EVSERVER.LOCAL -DeleteProtected:$false -AdminNote "Item deletion allowed $(get-date) by $(gc env:username)"
ユーザーが処理対象アーカイブのアイテムを手動で削除できるようにし、管理用のメモの修正を行います。
Get-EVArchive localhost Domain\User -OnHold:$false | Set-EVArchive -DeleteProtected:$true -DeleteExpiredItems:$false -Description "Archive placed on legal hold $(get-date) by $(gc env:username) from $(gc env:computername)"
Get-EVArchive によって、リーガルホールド状態ではなく、ユーザー Domain\User が削除権限を持っている、ローカル Enterprise Vault サーバー上のアーカイブの一覧が生成されます。Get-EVArchive は一覧を Set-EVArchive に渡します。そこでアーカイブはホールド状態になり、それに応じたアーカイブの説明が付けられます。
Set-EVArchive 14B...EVSERVER.LOCAL -RetentionPlanName RPForManagers
WARNING: This archive is associated with one or more targets that are associated with other archives. Changing the retention settings of this archive will change the retention settings of the listed archives.
Express Vault Store\A1
Express Vault Store\A2
Express Vault Store\A3
Confirm Do you want to continue? [Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
処理対象アーカイブに保持計画「RPForManagers」を適用します。アーカイブが他のアーカイブに関連付けられている 1 つ以上のターゲットに関連付けられている場合、このコマンドはまずアーカイブの一覧を表示し、続行の確認メッセージを表示します。「はい」を選択すると、コマンドは「RPForManagers」と呼ばれる保持計画を一覧表示したアーカイブに適用します。「N」または「S」を選択すると、コマンドは変更を適用せずに終了します。
Set-EVArchive 14B...EVSERVER.LOCAL -RetentionPlanName RPForManagers -Force
「RPForManagers」と呼ばれる保持計画を処理対象アーカイブに適用します。このアーカイブが他のアーカイブに関連付けられている 1 つ以上のターゲットに関連付けられている場合、このコマンドは確認メッセージを表示することなく、影響を受けるすべてのアーカイブの保持計画の更新に続行します。
Set-EVArchive 14B...EVSERVER.LOCAL -RetentionPlanName ""
処理対象アーカイブに以前適用された保持計画を削除します。保持計画を削除すると、アーカイブターゲットの有効な保持カテゴリが使用されます。

出力

表: Set-EVArchive プロパティは、利用可能なプロパティを一覧表示します。

表: Set-EVArchive プロパティ

名前	形式	説明
ArchiveId	文字列	変更するアーカイブの ArchiveId。
ArchiveName	文字列	変更するアーカイブの名前。
Updated	ブール値	アーカイブが cmdlet によって更新されたかどうかを示します。有効値は、$true (アーカイブは更新されました)、$false (アーカイブは更新されませんでした) です。