Enterprise Vault™ PowerShell Cmdlets

次の点に注意してください。

• コマンドレットを実行するユーザーには、指定されたタイプのアーカイブを管理するためにロールベースの管理権限が必要です。たとえば、Exchange メールボックスアーカイブを管理するには、ユーザーにはロールベースの管理権限「Can manage Exchange Mailbox Archives」が必要です。

• このコマンドレットを使用して、Active Directory または Domino Directory アカウントのあるユーザーのアクセス権限を設定できます。Domino ユーザーは、Domino メールボックスアーカイブでのみアクセス権限を持てます。Domino ユーザーを追加するには、Notes クライアントをインストールし、Enterprise Vault サーバーで Domino ドメインを構成する必要があります。

• このコマンドレットは、手動で設定した権限のみを付与または拒否します。このコマンドレットを使用して、自動的に設定された権限を変更することはできません。

• コマンドレットは、アーカイブでユーザーまたはグループが持つ現在の権限に指定した権限を追加し、現在の権限を上書きしません。たとえば、指定したアーカイブにユーザーまたはグループにすでに Read アクセスがあるときに -Grant Write を指定すると、Enterprise Vault は指定したアーカイブでそのユーザーまたはグループに読み取りと書き込み両方のアクセス権限を付与します。

• -Grant パラメータと -Deny パラメータは、特定のアクセスタイプに対して相互に排他的です。つまり、片方を設定するともう片方がクリアされます。たとえば、ユーザーまたはグループが指定したアーカイブで読み取りアクセスを拒否され、-Grant Read を指定した場合、コマンドレットはそのユーザーまたはグループに読み取りアクセス権限を付与します。

• -Deny で指定されている値は、-Grant で指定されている値に優先します。次に例を示します。

  • アクセスタイプを -Grant All -Deny Delete として指定すると、コマンドレットは、ユーザーまたはグループに読み取りおよび書き込みアクセスを付与しますが、アーカイブから項目を削除する権限を拒否します。

  • アクセスタイプを -Grant Delete -Deny All として指定すると、Enterprise Vault は、ユーザーまたはグループが -Grant Delete を使用して、アーカイブから項目を削除することを許可するように選択した場合でも、ユーザーまたはグループにアーカイブでのすべてのアクセスに対する権限を拒否します。

• アーカイブが削除対象としてマークされている場合、このコマンドレットは権限情報を更新しません。

• このコマンドレットの影響は、［アーカイブのプロパティ］ダイアログボックスの［権限］タブでユーザーのチェックボックスを選択するのと同じです。

• Set-EVArchivePermission -ArchiveId 19D...EVServer1 -Trustee EXAMPLE\msmith -Grant read

  ID「19D...EVServer1」のアーカイブでユーザー「EXAMPLE\msmith」の読み取りアクセス権限を付与します。

• Get-EVArchive -ArchiveName msmith | Set-EVArchivePermission -Trustee EXAMPLE\msmith -Deny d

  Get-EVArchive から取得したアーカイブ ID を Set-EVArchivePermission にパイプ処理し、アーカイブ「msmith」で Windows ユーザー「EXAMPLE\msmith」の削除権限を拒否します。

• Get-EVArchive -ArchiveName dsmith | Set-EVArchivePermission -Trustee dsmith/DominoOrg -Deny d

  Get-EVArchive から取得したアーカイブ ID を Set-EVArchivePermission にパイプ処理し、Domino メールボックスアーカイブ「dsmith」で Domino ユーザー「dsmith」に Domino Directory「DominoOrg」の削除権限を拒否します。

• Get-EVArchive -ArchiveName msmith | Set-EVArchivePermission -Trustee Example\Supervisors -Grant All -Deny R, W

  警告: Grant パラメータと Deny パラメータに同じ権限を設定しています。Deny パラメータで指定されている権限が優先します。コマンドレットは権限「拒否: R、W」を追加します。

  Confirm Do you want to continue? [Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y

  警告を表示し、続行の確認メッセージを表示します。［はい］を選択すると、コマンドによりグループ「EXAMPLE\Supervisors」に削除アクセス権限が付与され、アーカイブ「msmith」での読み取りおよび書き込みアクセス権限が拒否されます。

• Get-EVArchive -ArchiveName msmith | Set-EVArchivePermission -Trustee EXAMPLE\Supervisors -Grant Delete -Deny All -Confirm:$false

  警告を表示し、アーカイブ「msmith」で確認を求めずにグループ「EXAMPLE\Supervisors」の読み取り、書き込み、および削除アクセス権限を拒否します。

• Get-EVArchive -ArchiveName msmith | Get-EVArchivePermission | ForEach-Object { Set-EVArchivePermission -ArchiveId 19D...EVServer1 -Trustee $_.Trustee -Grant $_.ManualGranted -Deny $_.ManualDenied }

  Get-EVArchive から取得されるアーカイブ ID および Get-EVArchivePermission から取得されるアクセス権限の一覧をパイプ処理し、アーカイブ「msmith」で付与されるアクセス権限を ID「19D...EVServer1」のアーカイブにコピーします。

• Get-EVArchiveを参照してください。

• Get-EVArchivePermissionを参照してください。

• Remove-EVArchivePermissionを参照してください。