Enterprise Vault™ PowerShell Cmdlets

Last Published:
Product(s): Enterprise Vault (12.4)
  1. Introducing the Enterprise Vault PowerShell cmdlets
    1.  
      About the Enterprise Vault Management Shell
    2.  
      Getting Help for Enterprise Vault PowerShell cmdlets
    3.  
      Rules for PowerShell strings
    4. Where to get more information about Enterprise Vault
      1.  
        Enterprise Vault training modules
  2. Archiving: Exchange
    1.  
      Add-EVPstComputer
    2.  
      Add-EVPstFile
    3.  
      Get-EVExchangeMailboxPolicy
    4.  
      New-EVExchangeMailboxPolicy
    5.  
      Remove-EVExchangeFolderPolicy
    6.  
      Remove-EVExchangeMailboxPolicy
    7.  
      Set-EVExchangeMailboxPolicy
  3. Archiving: FSA
    1.  
      Get-EVFSAComputerSettings
    2.  
      Get-EVFSAFileServer
    3.  
      Get-EVFSAFolder
    4.  
      Get-EVFSASiteSettings
    5.  
      Get-EVFSAVolume
    6.  
      New-EVFSAFileServer
    7.  
      New-EVFSAFolder
    8.  
      New-EVFSAVolume
    9.  
      Remove-EVFSAFileServer
    10.  
      Remove-EVFSAFolder
    11.  
      Remove-EVFSAVolume
    12.  
      Set-EVFSAComputerSettings
    13.  
      Set-EVFSAFileServer
    14.  
      Set-EVFSAFolder
    15.  
      Set-EVFSASiteSettings
    16.  
      Set-EVFSAVolume
  4. Archiving: Skype for Business
    1.  
      Get-EVSkypeForBusinessTarget
    2.  
      New-EVSkypeForBusinessTarget
    3.  
      Remove-EVSkypeForBusinessTarget
    4.  
      Set-EVSkypeForBusinessTarget
  5. Archiving: SMTP
    1.  
      Get-EVSMTPHoldingFolder
    2.  
      Get-EVSMTPMessageTrackingLogLocation
    3.  
      Get-EVSMTPPolicy
    4.  
      Get-EVSMTPServerSettings
    5.  
      Get-EVSMTPTarget
    6.  
      New-EVSMTPPolicy
    7.  
      New-EVSMTPServerSettings
    8.  
      New-EVSMTPTarget
    9.  
      Remove-EVSMTPPolicy
    10.  
      Remove-EVSMTPTarget
    11.  
      Set-EVSMTPMessageTrackingLogLocation
    12.  
      Set-EVSMTPPolicy
    13.  
      Set-EVSMTPServerSettings
    14.  
      Set-EVSMTPTarget
    15.  
      Sync-EVSMTPServerSettings
  6. Backup
    1.  
      Clear-IndexLocationBackupMode
    2.  
      Clear-VaultStoreBackupMode
    3.  
      Get-IndexLocationBackupMode
    4.  
      Get-VaultStoreBackupMode
    5.  
      Set-IndexLocationBackupMode
    6.  
      Set-VaultStoreBackupMode
  7. Classification
    1.  
      Disable-EVClassification
    2.  
      Get-EVClassificationFCITags
    3.  
      Get-EVClassificationPolicy
    4.  
      Get-EVClassificationStatus
    5.  
      Get-EVClassificationTestMode
    6.  
      Get-EVClassificationVICTags
    7.  
      Import-EVClassificationFCIRules
    8.  
      Initialize-EVClassificationVIC
    9.  
      New-EVClassificationPolicy
    10.  
      Publish-EVClassificationFCIRules
    11.  
      Remove-EVClassificationPolicy
    12.  
      Set-EVClassificationPolicy
    13.  
      Set-EVClassificationTestMode
  8. Databases
    1.  
      Get-EVDatabase
    2.  
      Get-EVDatabaseDetail
    3.  
      Get-EVDatabaseFileInfo
    4.  
      Get-EVStorageDatabase
    5.  
      Set-EVDatabaseDetail
    6.  
      Start-EVDatabaseUpgrade
  9. IMAP access
    1.  
      Get-EVIMAPUsers
    2.  
      Get-EVIMAPUserSettings
    3.  
      Set-EVIMAPServerDisabled
    4.  
      Set-EVIMAPServerEnabled
  10. Indexing
    1.  
      Get-EVIndexLocation
    2.  
      Get-EVMDSStatus
    3.  
      Get-IndexServerForIndexLocation
    4.  
      New-EVMDSBuildTask
    5.  
      Set-IndexMetadataSyncLevel
  11. Records management
    1.  
      Export-EVNARAArchive
    2.  
      Get-EVRecordSettings
  12. Retention plans
    1.  
      Get-EVRetentionPlan
    2.  
      New-EVRetentionPlan
    3.  
      Remove-EVRetentionPlan
    4.  
      Set-EVRetentionPlan
  13. Roles-based administration
    1.  
      Add-EVRBARoleMember
    2.  
      Get-EVRBAAzStoreXml
    3.  
      Get-EVRBARole
    4.  
      Get-EVRBARoleMember
    5.  
      Remove-EVRBARoleMember
    6.  
      Set-EVRBAAzStoreXml
  14. Sites and servers
    1.  
      Get-EVComputers
    2.  
      Get-EVFileLocation
    3.  
      Get-EVIISWebsite
    4.  
      Get-EVServer
    5.  
      Get-EVSite
    6.  
      Get-EVSiteInfo
  15. Tasks and services
    1.  
      Get-EVDependencyService
    2.  
      Get-EVDependencyServiceState
    3.  
      Get-EVService
    4.  
      Get-EVServiceState
    5.  
      Get-EVTask
    6.  
      Get-EVTaskState
  16. Vault stores and archives
    1.  
      Export-EVArchive
    2.  
      Get-EVArchive
    3.  
      Get-EVArchivePermission
    4.  
      Get-EVVaultStore
    5.  
      Get-EVVaultStorePartition
    6.  
      Remove-EVArchive
    7.  
      Remove-EVArchivePermission
    8.  
      Set-EVArchive
    9.  
      Set-EVArchivePermission
    10.  
      Start-PartitionRollover

New-EVMDSBuildTask

New-EVMDSBuildTask creates an indexing task that builds (or rebuilds) a Metadata Store for an archive. The cmdlet must be run by a user with permission to manage indexes.

New-EVMDSBuildTask is provided by the snap-in Symantec.EnterpriseVault.PowerShell.Snapin.dll.

Syntax

New-EVMDSBuildTask [-ArchiveId] <String> -Mode <MDSBuildTaskMode> [-VerifyIndex [<MDSBuildTaskVerifyIndex>]] [-Force [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

Parameters

Table: New-EVMDSBuildTask parameters

Parameter

Description

-ArchiveId (required)

Identifies an Enterprise Vault archive.

-Mode (required)

Build, Rebuild. Use Build to create a new Metadata Store for the archive, or fill in gaps in the existing one. Use Rebuild to recreate the entire Metadata Store for the archive, overwriting any existing data.

-VerifyIndex

Default, Verify, NoVerify. In some cases the Metadata Store build task triggers an index verify task to ensure the Metadata Store is complete. This parameter can be used to enable or disable this behavior, overriding any default.

-Force

Creates the Metadata Store build task without prompting for confirmation.

-WhatIf

Describes what would happen if you executed the cmdlet without actually executing the cmdlet.

Examples
  • New-EVMDSBuildTask -Mode Build -ArchiveId 14B...EVSERVER.LOCAL

    Creates an indexing task that builds the Metadata Store for the specified archive. If the archive already has a Metadata Store, any missing items will be added where possible, but existing data will not be recreated.

  • New-EVMDSBuildTask -Mode Rebuild -ArchiveId 14B...EVSERVER.LOCAL

    Creates an indexing task that rebuilds the Metadata Store for the specified archive. Any existing data in the archive's Metadata Store will be overwritten.

  • New-EVMDSBuildTask -Mode Build -VerifyIndex NoVerify -ArchiveId 14B...EVSERVER.LOCAL

    Creates an indexing task that builds the Metadata Store for the specified archive, but will NOT allow the task to trigger a verification of the archive's index.

  • Import-Csv c:\archives.csv | New-EVMDSBuildTask -Mode Build

    Reads a list of archives from a CSV file, and creates a Metadata Store build task for each archive. One of the columns in the CSV file must be called 'ArchiveId'.

  • Get-Content c:\archives.txt | New-EVMDSBuildTask -Mode Build

    Reads a list of archive IDs from a text file (one per line), and creates a Metadata Store build task for each archive.

  • New-EVMDSBuildTask -Force -Mode Build -ArchiveId 14B...EVSERVER.LOCAL

    Uses the -Force parameter to suppress confirmation prompting.

  • New-EVMDSBuildTask -WhatIf -Mode Build -ArchiveId 14B...EVSERVER.LOCAL

    Uses the -WhatIf parameter to display the Metadata Store build tasks that would be created by the cmdlet, without actually creating the tasks.

Output

NewMDSBuildTaskResult

Table: New-EVMDSBuildTask properties lists the properties that are available.

Table: New-EVMDSBuildTask properties

Name

Type

Description

ArchiveId

String

The ArchiveId of the archive for which a task has been created.

ArchiveName

String

The name of the archive for which a task has been created.

Mode

MDSBuildTaskMode

The mode that is being used when building the archive. Possible values:"Build", "Rebuild".

VerifyIndex

MDSBuildTaskVerifyIndex

Indicates whether an index verify task will be created to verify that the Metadata Store is complete. Possible values: "Default", "Verify", "NoVerify".

Related cmdlets