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

Get-EVIndexVolume

Get-EVIndexVolume returns a list of index volumes in the Enterprise Vault site.

You can filter this list of index volumes to show the following:

  • Index volumes that contain a string in their ArchiveName, IndexServer, or IndexServerGroup

  • Index volumes that have one or more attributes, such as Online, Offline, Failed, ExtraItems, MixedIndexingLevel, MissingItems, or NotYetCreated

  • Index volumes of a platform, such as 64-bit, 32-bit, Elasticsearch, or all

  • Include/exclude index volumes that are currently being processed

  • Show index volumes in fixed-sized groups/pages with a PageSize and traverse through them with a PageIndex

Additional info:

  • PageSize - If PageSize is greater than the total number of index volumes present on the system, then all index volumes will be displayed. If PageSize is less than the total number of index volumes on the system, then only the index volumes 1 to PageSize will be displayed along with a warning stating that more index volumes are found but not displayed.

  • PageIndex - Indexing starts from 1 and not 0.

Get-EVIndexVolume is provided by the snap-in Symantec.EnterpriseVault.PowerShell.AdminAPI.dll.

Syntax

Get-EVIndexVolume [[-SiteId] <String>] [-FilterBy {ArchiveName | IndexServerGroup | IndexServer}] [-FilterValue <String>] [-Attributes {All | Online | Offline | Failed | ExtraItems | MixedIndexingLevel | MissingItems | NotYetCreated}] [-Platform {All | 32bit | 64bit | Elasticsearch}] [-ExcludeBeingProcessed [<SwitchParameter>]] [-PageIndex <int>] [-PageSize <int>] [<CommonParameters>]

Parameters

Table: Parameters for Get-EVIndexVolume

Parameter

Type

Description

-SiteId

String

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

-FilterBy

String

Possible values: ArchiveName, IndexServer, or IndexServerGroup

Identifies the property on which the search string provided in the FilterValue parameter will be applied.

FilterBy must be used along with -FilterValue.

-FilterValue

String

Defines the search string that will be used to filter the index volumes based on the property mentioned by the FilterBy parameter. A string consisting of any valid alpha-numeric characters is a valid input.

FilterValue must be used along with -FilterBy.

-Attributes

List<String>

Possible values: Online, Offline, Failed, ExtraItems, MixedIndexingLevel, MissingItems, NotYetCreated, or All

Default value: All

Filters the index volume list according to the status and condition of the index volumes based on the list of one or more pre-defined attributes. The parameter can be set to any combination of the allowed values or simply "All" to include all attributes. Duplicates in the list of Attributes will be ignored. For example: "Online, Online, Failed, NotYetCreated, Failed".

-Platform

List<String>

Possible values: 32bit, 64bit, Elasticsearch, or All

Default value: All

Filters the index volume list according to the platform of the index volumes, whether they are 32-bit, 64-bit, or Elasticsearch. The parameter can be set to any combination of the allowed values or simply "All" to include all platforms. Duplicates in the list of platforms will be ignored. For example: "32bit", "64bit", "Elasticsearch", "All".

-ExcludeBeingProcessed

SwitchParameter

Default value: $false

Excludes the index volumes that are currently being processed from the list of index volumes that are returned. Do not mention this parameter to include the index volumes being processed into the index volume list.

-PageSize

Integer

Default value: 50000

Specifies the maximum number of index volumes that will be returned by the cmdlet at once. PageSize can be used along with PageIndex to perform pagination on the list of index volumes.

-PageIndex

Integer

Default value: 1

Specifies the index of the page of index volumes that need to be returned. It should be used in conjunction with PageSize to divide the index volumes into groups of preferred size, where the size is defined by PageSize and the index of the group/page is provided by the PageIndex. For example: on a system with 1000 index volumes with PageSize provided as 100, PageIndex 1 will return index volumes 1 - 100, PageIndex 2 will return index volumes 101 - 200, and so on.

Outputs

Table: Outputs of Get-EVIndexVolume

Name

Type

Description

IndexVolumeIdentity

Integer

The ID of index volume.

ArchiveName

String

The name of the archive that the index volume is associated with.

ArchiveType

EV_STG_API_ARCHIVE_TYPE

The type of the archive that the current index volume is associated with.

ArchiveID

String

The ID of the archive that the index volume is associated with.

BackupMode

String

Indicates whether the index volume is in backup mode.

IndexedItems

Long

The total number of items that are currently indexed by the index volume.

Indexer

String

The name of the index server that the index volume belongs to.

IndexServerGroup

String

The name of the index server group that the index volume belongs to.

Location

String

The physical location of the index volume on the disk.

MissingItems

Long

The total number of items that are missing from the index volume.

Range

String

The range of items indexed by the index volume.

Status

String

The current status of the index volume. It can be Online, Offline, Failed, or NotYetCreated.

Platform

String

The platform of the index volume. It can be 32-bit, 64-bit, or Elasticsearch.

TaskName

String

The name of the indexing task that the index volume is a part of. If the index volume is not part of any task, then this field returns the value '(None)'.

YoungestItemDate

String

The archived date of the most recent item in the index volume.

OldestItemDate

String

The archived date of the oldest item in the index volume.

Examples
  • Get-EVIndexVolume

    Lists all index volumes in the Enterprise Vault site.

  • Get-EVIndexVolume -FilterBy ArchiveName -FilterValue "SMTP"

    Filters the list of index volumes to show only those index volumes that contain the string "SMTP" in their ArchiveName.

  • Get-EVIndexVolume -Attributes Offline, NotYetCreated -Platform 32bit

    Filters the list of index volumes to show only those index volumes that are either Offline or NotYetCreated and are 32-bit index volumes.

  • Get-EVIndexVolume -FilterBy IndexServerGroup -FilterValue GenericGroupName -ExcludeBeingProcessed

    Filters the list of index volumes to show only those index volumes that belong to index server groups that have the string GenericGroupName in their name, and which are not currently being processed.

  • Get-EVIndexVolume -Attributes Online -Platform 64bit -PageSize 4 -PageIndex 3

    Filters the list of index volumes to show the 9th to 12th index volumes (after being sorted by ArchiveName) that are Online and are 64-bit index volumes.

Related cmdlets