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-EVIndexSnapshot

Get-EVIndexSnapshot retrieves details of index snapshot of the specified Enterprise Vault index server in the specified Enterprise Vault site.

Syntax
  • Get-EVIndexSnapshot [-EVServerName <String>] [-SnapshotName <String>] [-RepositoryName <String>] [-State {Failed | Success | InProgress | Partial}] [-Latest <SwitchParameter>] [<CommonParameters>]

  • Get-EVIndexSnapshot -SiteId <String> [-EVServerName <String>] [-SnapshotName <String>] [-RepositoryName <String>] [-State {Failed | Success | InProgress | Partial}] [-Latest <SwitchParameter>] [<CommonParameters>]

Get-EVIndexSnapshot retrieves details of specified or all index snapshot(s) of the specified Enterprise Vault index server in the specified Enterprise Vault site.

It also retrieves details of all the index snapshots of all the Enterprise Vault index servers in the specified Enterprise Vault site.

Get-EVIndexSnapshot is provided by Symantec.EnterpriseVault.PowerShell.AdminAPI.dll, which the Enterprise Vault Management Shell loads.

Parameters

Table: Get-EVIndexSnapshot parameters

Parameter

Description

-SiteId

The ID of the Enterprise Vault site for which you want to retrieve the index snapshots.

If you omit this parameter, Get-EVIndexSnapshot retrieves the SiteId from the Enterprise Vault index server specified as EVServerName parameter; otherwise, it uses the SiteId of the Enterprise Vault index server where the command is running. You can use the Get-EVSite command to obtain the SiteId.

-EVServerName

The name of the Enterprise Vault index server for which you want to retrieve the index snapshots.

If you omit this parameter, Get-EVIndexSnapshot uses the host name of the Enterprise Vault index server where the command is running. You can use the Get-EVComputers command to obtain the Enterprise Vault server name.

-SnapshotName

The name of the index snapshot for which you want to retrieve details.

-RepositoryName

The name of the index snapshot repository from which you want to retrieve details of the index snapshots.

-State

Filters list of returned index snapshots based on its state.

-Latest

This filter shows only latest index snapshot.

Examples
  • C:\PS> Get-EVIndexSnapshot

    List all the index snapshots of the current Enterprise Vault index server on which this command is executed.

  • C:\PS> Get-EVIndexSnapshot -ServerName win12r2.domain.local

    List all the index snapshots of the Enterprise Vault index server 'win12r2.domain.local'.

  • C:\PS> Get-EVIndexSnapshot -EVServerName win12r2.domain.local

    List all the index snapshots of the Enterprise Vault index server 'win12r2.domain.local'.

  • C:\PS> Get-EVIndexSnapshot -SnapshotName 'fd10805e-1a95-4ddd-bbc1-45a3a346e48d'

    Retrieve details of index snapshots with name 'fd10805e-1a95-4ddd-bbc1-45a3a346e48d' for the current Enterprise Vault index server on which command is executed.

  • C:\PS> Get-EVIndexSnapshot -RepositoryName '8ghcfcef-2502-4ff4-a066-f3fb165c7f09'

    List all the index snapshots created in the index snapshot repository '8ghcfcef-2502-4ff4-a066-f3fb165c7f09' for the current Enterprise Vault index server.

  • C:\PS> Get-EVIndexSnapshot -State InProgress

    List all the index snapshots that are in progress for the current Enterprise Vault index server.

  • C:\PS> Get-EVIndexSnapshot -RepositoryName '1afcfcef-2502-4ff4-a066-f3fb165c7f08' -State:0

    List all the index snapshots inside repository '1afcfcef-2502-4ff4-a066-f3fb165c7f08' for the current Enterprise Vault index server that are successful.

  • C:\PS> Get-EVIndexSnapshotRepository | Get-EVIndexSnapshot

    Lists all index snapshots created in all index snapshot repositories returned by the command Get-EVIndexSnapshotRepository.

  • C:\PS> Get-EVIndexSnapshotLocation -OnlyActive| Get-EVIndexSnapshotRepository -OnlyInUse | Get-EVIndexSnapshot

    Lists all index snapshots created in index snapshot repository which in-use in the active index snapshot location for the current Enterprise Vault index server.

  • C:\PS> Get-EVIndexSnapshot -SiteId 1400222F70EEFC04AA6B63C233696BB491d10000Win12R2.domain.local

    Lists all index snapshots of all Enterprise Vault index servers in the Enterprise Vault site '1400222F70EEFC04AA6B63C233696BB491d10000Win12R2.domain.local'.

  • C:\PS> Get-EVIndexSnapshot -SiteId 1400222F70EEFC04AA6B63C233696BB491d10000Win12R2.domain.local -EVServerName win12r2.domain.local

    Lists all index snapshots of Enterprise Vault index server 'win12r2.domain.local' in the Enterprise Vault site '1400222F70EEFC04AA6B63C233696BB491d10000Win12R2.domain.local' -EVServerName.

  • C:\PS> Get-EVSite | Get-EVIndexSnapshot

    Lists all index snapshots of all Enterprise Vault index servers in the Enterprise Vault site returned by the Get-EVSite command.

  • C:\PS> Get-EVComputers | Get-EVIndexSnapshot

    Lists all index snapshots of all Enterprise Vault index servers returned by the Get-EVComputers command.

  • C:\PS> Get-EVIndexSnapshot -Latest:$true

    Retrieve details of latest index snapshot for the current Enterprise Vault index server on which command is executed.

  • C:\PS> Get-EVSite | Get-EVIndexSnapshot -Latest:$true

    Retrieve details of latest index snapshots for all Enterprise Vault index servers in the Enterprise Vault site returned by command Get-EVSite.

Output

Symantec.EnterpriseVault.Admin.IndexSnapshot

This command returns the object(s) of type Symantec.EnterpriseVault.Admin.IndexSnapshot composed of the following properties:

Name

Type

Description

SiteId

String

The ID of the Enterprise Vault site in which the index snapshot is created.

SiteNameOrId

String

The name or ID of the Enterprise Vault site in which the index snapshot is created.

SnapshotServerName

String

The name of Enterprise Vault index server in which the index snapshot is created.

RepositoryName

String

Name of the index snapshot repository in which the index snapshot is created.

RepositoryFullPath

String

The path where the index snapshot is created.

SnapshotIdentity

Integer

An identifier to identify the individual index snapshot.

SnapshotName

String

Name of the index snapshot.

Version

String

The version of Elasticsearch being used to create the index snapshot.

SnapshotState

EnterpriseVault.Admin.SnapshotStates

Indicates the state of the index snapshot.

CreatedDate

Integer

The date on which index snapshot was taken.

FailureReason

String

In case of failure in 'SnapshotState', this states the reason of failure.

Related cmdlets