Enterprise Vault™ PowerShell Cmdlets

Last Published:
Product(s): Enterprise Vault (14.2)
  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.  
      Get-EVIndexSnapshotLocationBackupMode
    2.  
      Set-EVIndexSnapshotLocationBackupMode
    3.  
      Clear-EVIndexSnapshotLocationBackupMode
    4.  
      Get-IndexLocationBackupMode
    5.  
      Set-IndexLocationBackupMode
    6.  
      Clear-IndexLocationBackUpMode
    7.  
      Get-VaultStoreBackupMode
    8.  
      Set-VaultStoreBackupMode
    9.  
      Clear-VaultStoreBackupMode
    10.  
      Set-EVIndexSnapshotLocation
    11.  
      Get-EVIndexSnapshotLocation
    12.  
      Remove-EVIndexSnapshotLocation
    13.  
      New-EVIndexSnapshot
    14.  
      Get-EVIndexSnapshot
    15.  
      Remove-EVIndexSnapshot
    16.  
      Restore-EVIndexSnapshot
    17.  
      Get-EVIndexSnapshotRepository
    18.  
      Remove-EVIndexSnapshotRepository
  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.  
      Set-EVClassificationVICFIPSMode
    10.  
      New-EVClassificationPolicy
    11.  
      Publish-EVClassificationFCIRules
    12.  
      Remove-EVClassificationPolicy
    13.  
      Set-EVClassificationPolicy
    14.  
      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
    6.  
      Submit-EVIndexingSubTask
    7.  
      Get-EVIndexVolume
    8.  
      Get-EVElasticsearchIndex
  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

Submit-EVIndexingSubTask

The Submit-EVIndexingSubTask cmdlet submits new indexing related subtasks, such as Rebuild, Synchronize, Verify, and Upgrade specified using the Type parameter.

Table: Subtask types and usage

Subtask type

Usage

Rebuild

To completely rebuild index volumes. It also upgrades 32-bit and 64-bit index volumes to Elasticsearch, if necessary. The old index volumes remain searchable during the rebuild to avoid any impact on users.

Synchronize

To synchronize index volumes and fix the known issues. The Synchronize task attempts to index items that were not indexed previously and are reported as missing items in the Index Volume Brower.

Verify

To check that index volumes are accessible and healthy. You can apply verification level as Complete verification or Basic verification. The Basic verification checks index volumes for critical issues. The Complete verification checks for critical issues, and also runs an item-level verification to check for items that are indexed but not present in the archive, and items that are archived but not indexed.

Upgrade

To upgrade the archives that have 32-bit and 64-bit index volumes to use Elasticsearch index volumes. The old indexes remain available during the upgrade so that user searches are unaffected. Note: Before you upgrade an index volume, execute Synchronize on the same index volume to fix issues that have been identified already.

You need to specify the targets by mentioning a list of ArchiveIDs, IndexLocationIDs and/or IndexVolumeIDs parameters, the values can be retrieved from Get-EVArchive, Get-EVIndexLocation, and Get-EVIndexVolume cmdlets respectively. Optionally, by using the Name parameter, you can specify a name for the subtask to be created.

You get errors in the following scenarios:

  • If you do not mention index locations, archives, and/or index volumes.

  • If you mention invalid combinations of parameters.

You get warnings in the following scenarios:

  • If you specify already processing index locations, archives, and/or index volumes.

  • If you specify index locations, archives, and/or index volumes that do not exist in the database.

  • If you specify index locations, archives, and/or index volumes that are already mentioned in the command.

  • If you specify the index location of Elasticsearch type or that does not contain any index volumes.

  • If you specify the archives to upgrade that do not have 32-bit or 64-bit index volumes.

Submit-EVIndexingSubTask is provided by the snap-in Symantec.EnterpriseVault.PowerShell.AdminAPI.dll.

Syntax

Submit-EVIndexingSubTask [[-SiteId] <string>] -Type {Rebuild | Synchronize | Verify | Upgrade} [-Name <String>] [-IndexLocationIDs <List<String>>] [-ArchiveIDs <List<String>>] [-IndexVolumeIDs <List<int>>] [-IgnoreFailedItems [<SwitchParameter>]] [-VerificationLevel {Basic | Complete}] [-AutoSynchronize [<SwitchParameter>]] [-IncludeContentMissingDetails [<SwitchParameter>]] [<CommonParameters>]

Parameters

Table: Parameters for Rebuild

Parameter

Type

Description

-SiteId

String

The ID of the Enterprise Vault site for which you want to submit the index sub task. You can use Get-EVSite to obtain the site ID.

-Type (required)

INDEXING_SUBTASK_TYPE

Possible values: Rebuild, Synchronize, Verify, or Upgrade

The type of indexing subtask you want to perform.

-Name

String

The name for the indexing subtask. You can give any custom name where allowed characters are alpha-numeric, hyphen (-), underscore (_), space, colon (:), brackets ([]). If you do not specify this parameter, then the cmdlet will automatically generate a unique name.

-ArchiveIDs

List<String>

The list of IDs of the archives on which the indexing subtask will be performed. Each value must follow the EV GUID format. You can use Get-EVArchive to obtain the list of available IDs.

-IndexVolumeIDs

List<int>

The list of IDs of the index volumes on which the indexing subtask will be performed. Each value must be of integer type. You can use Get-EVIndexVolume to obtain the list of available IDs.

-IgnoreFailedItems

SwitchParameter

Default value: $false

This parameter can be specified only if Type is mentioned as Upgrade or Rebuild. If specified, the cmdlet ignores any errors and completes the subtasks. Otherwise, by default, the cmdlet waits for the user interaction to complete the task in case of errors.

Table: Parameters for Synchronize

Parameter

Type

Description

-SiteId

String

The ID of the Enterprise Vault site for which you want to submit the index sub task. You can use Get-EVSite to obtain the site ID.

-Type (required)

INDEXING_SUBTASK_TYPE

Possible values: Rebuild, Synchronize, Verify, or Upgrade

The type of indexing subtask you want to perform.

-Name

String

The name for the indexing subtask. You can give any custom name where allowed characters are alpha-numeric, hyphen (-), underscore (_), space, colon (:), brackets ([]). If you do not specify this parameter, the cmdlet will automatically generate a unique name.

-IndexVolumeIDs

List<int>

The list of IDs of the index volumes on which the indexing subtask will be performed. Each value must be of integer type. You can use Get-EVIndexVolume to obtain the list of available IDs.

Table: Parameters for Verify

Parameter

Type

Description

-SiteId

String

The ID of the Enterprise Vault site for which you want to submit the index sub task. You can use Get-EVSite to obtain the site ID.

-Type (required)

INDEXING_SUBTASK_TYPE

Possible values: Rebuild, Synchronize, Verify, or Upgrade.

The type of indexing subtask you want to perform.

-Name

String

The name for the indexing subtask. You can give any custom name where allowed characters are alpha-numeric, hyphen (-), underscore (_), space, colon (:), brackets ([]). If you do not specify this parameter, then the cmdlet will automatically generate a unique name.

-IndexLocationIDs

List<String>

The list of IDs of the index locations on which the indexing subtask will be performed. Each value must follow the EV GUID format. You can use Get-EVIndexLocation to obtain the list of available IDs.

-ArchiveIDs

List<String>

The list of IDs of the archives on which the indexing subtask will be performed. Each value must follow the EV GUID format. You can use Get-EVArchive to obtain the list of available IDs.

-IndexVolumeIDs

List<int>

The list of IDs of the index volumes on which the indexing subtask will be performed. Each value must be of integer type. You can use Get-EVIndexVolume to obtain the list of available IDs.

-VerificationLevel

VERIFICATION_LEVEL

Possible values: Complete, Basic

Type of verification level you want to apply on archives, index volumes, or index locations. The Verification Level should be either Complete or Basic. The Complete verification level checks that the index volume is accessible and healthy, and completes an item-level verification of the index volume. It identifies items that exist in the archive but are not indexed, and items that are indexed but are no longer in the archive. The Basic verification level checks that the index volume is accessible and healthy.

-AutoSynchronize

SwitchParameter

If specified, creates a synchronization task automatically for each index volume in which there are errors. It can be specified only if the Type is mentioned as Verify and the Verification Level is set to Complete.

-IncludeContentMissingDetails

SwitchParameter

Specify if you want each item that is missing content to be logged individually. It can be specified only if the Type is mentioned as Verify and the Verification Level is set to Complete.

Table: Parameters for Upgrade

Parameter

Type

Description

-SiteId

String

The ID of the Enterprise Vault site for which you want to submit the index sub task. You can use Get-EVSite to obtain the site ID.

-Type (required)

INDEXING_SUBTASK_TYPE

Possible values: Rebuild, Synchronize, Verify, or Upgrade

The type of indexing subtask you want to perform.

-Name

String

The name for the indexing subtask. You can give any custom name where allowed characters are alpha-numeric, hyphen (-), underscore (_), space, colon (:), brackets ([]). If you do not specify this parameter, then the cmdlet will automatically generate a unique name.

-ArchiveIDs

List<String>

The list of IDs of the archives on which the indexing subtask is to be performed. Each value must follow EV GUID format. You can use Get-EVArchive to obtain the list of available IDs.

-IgnoreFailedItems

SwitchParameter

Default value: $false

It can be specified if Type is mentioned as Upgrade or Rebuild. If specified, the cmdlet ignores any errors and completes the subtasks. Otherwise, by default the cmdlet waits for the user interaction to complete the task in case of errors.

Outputs

Prints a message that the subtask was submitted successfully.

Examples
  • Submit-EVIndexingSubTask -Type Rebuild -ArchiveIDs '111...example.com','122...example.com' -IndexVolumeIDs 123,456

    This command creates a new indexing subtask to rebuild the specified archives and index volumes. You can also specify a custom name for the subtask by using the -Name parameter. Also, the newly-created subtask does not ignore any errors encountered during the processing and marks it as waiting for user interaction.

  • Submit-EVIndexingSubTask -Type Rebuild -ArchiveIDs '111...example.com','122...example.com' -IndexVolumeIDs 123,456 -Name 'Rebuild task' -IgnoreFailedItems

    This command creates a new indexing subtask with a name "Rebuild task" to rebuild the specified archives and index volumes. Also, the newly-created subtask ignores any errors encountered during processing and marks it as completed with errors.

  • Submit-EVIndexingSubTask -Type Synchronize -IndexVolumeIDs 123,456

    This command creates a new indexing subtask to synchronize the specified index volumes.

  • Submit-EVIndexingSubTask -Type Verify -IndexLocationIDs '133...example.com', '144...example.com' -ArchiveIDs '111...example.com','122...example.com' -IndexVolumeIDs 123,456

    This command creates a new indexing subtask to verify the specified index locations, archives, and index volumes. The verification level of the subtask is Complete.

  • Submit-EVIndexingSubTask -Type Verify -IndexLocationIDs '133...example.com', '144...example.com' -VerificationLevel Complete -AutoSynchronize -IncludeContentMissingDetails

    This command creates a new indexing subtask to verify the specified index locations. The verification level of the subtask is Complete. It creates a synchronization subtask automatically for each index volume in which there are errors. Also, each item in the subtask that is missing content is logged individually.

  • Submit-EVIndexingSubTask -Type Verify -IndexLocationIDs '133...example.com', '144...example.com' -VerificationLevel Basic

    This command creates a new indexing subtask to verify the specified index locations. The verification level of the subtask is Basic.

  • Submit-EVIndexingSubTask -Type Upgrade -ArchiveIDs '111...example.com','122...example.com'

    This command creates a new indexing sub-task to upgrade the specified archives. Also, the newly created sub-task does not ignore any errors encountered during the processing and marks it as waiting for user interaction.

  • Submit-EVIndexingSubTask -Type Upgrade -ArchiveIDs '111...example.com','122...example.com' -IgnoreFailedItems

    This command creates a new indexing sub-task to upgrade the specified archives. Also, the newly created sub-task ignores any errors encountered during processing and marks it as completed with errors.

  • $archives = Get-EVArchive | where ArchiveName -Match 'abc' Submit-EVIndexingSubTask -Type Rebuild -ArchiveIDs $archives.ArchiveId

    This script first retrieves a list of archives having string "abc" in their name and then creates a new indexing subtask to rebuild those archives.

  • $volumes = Get-EVIndexVolume -Attributes ExtraItems,Failed,MissingItems

    Submit-EVIndexingSubTask -Type Synchronize -IndexVolumeIDs $volumes.IndexVolumeIdentity

    This script first retrieves a list of index volumes that are failed or has extra or missing items. It then creates a new indexing subtask to synchronize those index volumes.

  • $location = Get-EVIndexLocation | where IndexRootPath -eq "C:\EVStorage\Index\index7"

    Submit-EVIndexingSubTask -Type Verify -IndexLocationIDs $location.IndexRootPathEntryId -VerificationLevel Complete

    This script first retrieves an index location with the specified index root path and then creates a new indexing subtask to verify that index location.

Related cmdlets