Veritas Enterprise Vault™ PowerShell Cmdlets

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

Import-EVClassificationRules

Import-EVClassificationRules imports all the Enterprise Vault classification properties and rules from a file into the target servers. Before the cmdlet does this, it clears any existing properties and rules from those servers.

This cmdlet performs a similar function to the Publish-EVClassificationRules cmdlet. The difference is that Publish-EVClassificationRules first exports the classification properties and rules to an XML file before it publishes them to the target servers; Import-EVClassificationRules uses an existing XML file to perform the import part of the operation only.

Note the following:

  • To run this cmdlet, you must have the system administrator role on both the server where you run the cmdlet and on all the target servers.

  • Install the Microsoft Data Classification Toolkit on the server where you run this cmdlet. You can download the toolkit from the following webpage:

    http://www.microsoft.com/download/details.aspx?id=27123

  • If you do not run the cmdlet on an Enterprise Vault server, you must specify either the -SiteId or -Servers parameter. If you run the cmdlet on an Enterprise Vault server and omit these parameters, the cmdlet uses the site of the current server to publish to all the other Enterprise Vault servers in the site.

  • In a cluster configuration (either Windows Server Failover Clustering or Veritas Cluster Server), if you import the classification properties and rules into one cluster node then all the other nodes are also updated. So, after a failover to another node, classification continues with the same rules as before.

  • In an Enterprise Vault Building Blocks environment, this cmdlet imports only to servers that are currently hosting Enterprise Vault tasks and services.

  • This cmdlet stops the Enterprise Vault Storage service on each target server and then, after it has imported the classification properties and rules, restarts the service.

    Note:

    Other methods for publishing the classification properties and rules do not automatically stop and then restart the Storage service, and this can lead to classification errors. For example, this is the case if you use the PowerShell cmdlets that come with the Microsoft Data Classification Toolkit. Therefore, we strongly recommend that you use Import-EVClassificationRules (or Publish-EVClassificationRules) to publish the classification properties and rules.

Import-EVClassificationRules is provided by Symantec.EnterpriseVault.PowerShell.Snapin.dll, which is loaded by the Enterprise Vault Management Shell.

Syntax

Import-EVClassificationRules [-ImportRulesFile <string>] [-SiteId <string>] [-Servers <string>] [-TimeoutSecs <integer>] [-Confirm <Boolean>]

Parameters

Table: Import-EVClassificationRules parameters

Parameter

Description

-ImportRulesFile (required)

Specifies the file from which the cmdlet imports the classification properties and rules. The file must have a .xml file name extension.

-SiteId

Identifies the site to which you want to publish the classification properties and rules.

If you set this parameter, you cannot set the -Servers parameter as well.

-Servers

Nominates the servers that will receive the set of classification properties and rules. Type the NETBIOS name, IP address, or fully-qualified domain name of each server in a comma-separated list. To specify the local computer, type the computer name "localhost".

If you set this parameter, you cannot set the -SiteId parameter as well.

-TimeoutSecs

Sets the timeout value in seconds when the cmdlet stops or starts the Enterprise Vault Storage service on each of the target servers. The default is 300 seconds.

Note:

If the cmdlet fails to restart a service within the specified period, check the state of the classification rules and Storage services on the failed servers. A server can be left without classification rules if the cmdlet clears the existing rules without also importing the new ones.

-Confirm

When set to $true (the default value), causes the cmdlet to prompt you for confirmation before it imports the classification properties and rules. Set to $false to suppress the prompts.

Examples
  • Import-EVClassificationRules -ImportRulesFile c:\Data\RulesFile.xml

    Imports the classification properties and rules that are in the specified file into all the Enterprise Vault servers that are in the current site (that is, the same site as the server on which you run the cmdlet).

  • Import-EVClassificationRules -ImportRulesFile c:\Data\RulesFile.xml -SiteId 13E...EV.example.com

    Imports the classification properties and rules that are in the specified file into all the Enterprise Vault servers that are in the specified site.

  • Import-EVClassificationRules -ImportRulesFile c:\Data\RulesFile.xml -Servers SERVER1,SERVER2.ABC.DEF.COM

    Imports the classification properties and rules that are in the specified file into all the specified servers.

Output

This cmdlet returns objects of type Symantec.EnterpriseVault.PowerShell.Commands.ServerInfo, which has the following default properties.

Table: Import-EVClassificationRules properties

Name

Type

Description

ServerName

String

The name of the Enterprise Vault server.

ServerFQDN

String

The fully qualified domain name of the Enterprise Vault server.

Result

String

The import result (Succeeded/Failed/DuplicateServer).

ErrorMessage

String

The error reason, if the import to the server was not successful.

Related cmdlets