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

New-EVIndexSnapshot

New-EVIndexSnapshot creates the snapshot of index data on the specified Enterprise Vault index server in the specified Enterprise Vault site.

Syntax
  • New-EVIndexSnapshot [-EVServerName <String>] [-IgnoreUnavailable [<SwitchParameter>]] [-IncludeGlobalState [<SwitchParameter>]] [<CommonParameters>]

  • New-EVIndexSnapshot -SiteId <String> [-EVServerName <String>] [-IgnoreUnavailable [<SwitchParameter>]] [-IncludeGlobalState [<SwitchParameter>]] [<CommonParameters>]

New-EVIndexSnapshot creates the incremental snapshot of index data on the specified Enterprise Vault index server in the specified Enterprise Vault site.

It also creates the incremental snapshot of index data on the Enterprise Vault index servers in the specified Enterprise Vault site. The snapshots are incremental and can be taken on live index data during indexing is in progress.

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

Parameters

Table: New-EVIndexSnapshot parameters

Parameter

Description

-SiteId

The ID of the Enterprise Vault site for which you want to create the snapshots of index data on all the Enterprise Vault index servers in that site.

If you omit this parameter, New-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 create the snapshot of index data.

If you omit this parameter, New-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.

-IgnoreUnavailable

(Optional, Boolean) If false, the command returns an error for any data stream or index that is missing or closed. Defaults to false.

If true, the command ignores data streams and indices those are missing or closed.

-IncludeGlobalState

(Optional, Boolean) If true, the current global state of Elasticasearch cluster running on Enterprise Vault index server is included in the snapshot. Defaults to false.

-Confirm

You can use the Confirm switch to suppress the confirmation prompt that appears by default when this cmdlet is run. To suppress the confirmation prompt, use the syntax -Confirm:$False. You must include a colon ( : ) in the syntax.

Examples
  • C:\PS> New-EVIndexSnapshot

    Creates index snapshot of the current Enterprise Vault index server on which this command is executed.

  • C:\PS> New-EVIndexSnapshot -SiteId site.domain.com

    Creates index snapshot of all Enterprise Vault index servers under site 'site.domain.com'.

  • C:\PS> New-EVIndexSnapshot -EVServerName ev.domain.local

    Create index snapshot of the Enterprise Vault index server 'ev.domain.local'.

  • C:\PS> New-EVIndexSnapshot -EVServerName ev.domain.local -IgnoreUnavailable

    Create index snapshot of the Enterprise Vault index server 'ev.domain.local', if IgnoreUnavailable is set to false, the command returns an error for any data stream or index that is missing or closed. If true, the command ignores data streams and indices in indices that are missing or closed.

  • C:\PS> New-EVIndexSnapshot -EVServerName ev.domain.local -IncludeGlobalState

    Create index snapshot of the Enterprise Vault index server 'ev.domain.local'. If IncludeGlobalState is true, the current global state of Elasticasearch cluster running on Enterprise Vault index server is included in the snapshot.

  • C:\PS> New-EVIndexSnapshot -EVServerName ev.domain.local -IgnoreUnavailable -IncludeGlobalState

    Create index snapshot of the Enterprise Vault index server 'ev.domain.local', if IgnoreUnavailable is set to false, the command returns an error for any data stream or index that is missing or closed. If true, the command ignores data streams and indices in indices that are missing or closed. If IncludeGlobalState is true, the current global state of Elasticasearch cluster running on Enterprise Vault index server is included in the snapshot.

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

Date

The date on which index snapshot was taken.

FailureReason

String

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

Related cmdlets