Enterprise Vault™ PowerShell Cmdlets

Last Published:
Product(s): Enterprise Vault (12.3)
  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-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: 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.  
      Clear-IndexLocationBackupMode
    2.  
      Clear-VaultStoreBackupMode
    3.  
      Get-IndexLocationBackupMode
    4.  
      Get-VaultStoreBackupMode
    5.  
      Set-IndexLocationBackupMode
    6.  
      Set-VaultStoreBackupMode
  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.  
      New-EVClassificationPolicy
    10.  
      Publish-EVClassificationFCIRules
    11.  
      Remove-EVClassificationPolicy
    12.  
      Set-EVClassificationPolicy
    13.  
      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
  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-EVVaultStore
    4.  
      Get-EVVaultStorePartition
    5.  
      Remove-EVArchive
    6.  
      Set-EVArchive
    7.  
      Start-PartitionRollover

Get-EVRecordSettings

Get-EVRecordSettings provides information on the records management settings in one or more archives. To implement Capstone or an equivalent records management system, it is necessary to mark items as records so that you can easily categorize, search for, export, and dispose of them. For guidelines on using Enterprise Vault for records management, see the Administrator's Guide.

Get-EVRecordSettings is provided by the snap-in Symantec.EnterpriseVault.PowerShell.Snapin.dll.

Syntax

Get-EVRecordSettings [-ArchiveId <String>] [-ArchiveName <String>] [-User <String>] [-RetentionPlan <String>] [-RecordType <String>] [-RetentionCategory <String>] [-SiteId <String>] [<CommonParameters>]

Parameters

Table: Get-EVRecordSettings parameters

Parameter

Description

-ArchiveId

Specifies the ID of the archive for which to return the records management settings. You can use Get-EVArchive to obtain the required ID.

-ArchiveName

Specifies the name of an archive for which to return the records management settings. The cmdlet may return the settings for multiple archives if they all share the same name.

-User

Specifies the name of a user for whom to return the records management settings for all the archives in which the user has write permissions. Type the name in the form domain\user.

-RetentionPlan

Specifies the name of a retention plan for which to return the records management settings for all the archives to which you have applied the plan.

-RecordType

Specifies a record type (Permanent or Temporary) for which to return the records management settings for all the archives in which it is the default type. The retention category specified in the retention plan that you have applied to an archive determines the archive's default record type.

-RetentionCategory

Specifies a retention category for which to return the records management settings for all the archives to which you have applied a retention plan with this retention category.

-SiteId

Specifies the ID of the target Enterprise Vault site. This parameter is mandatory if you run the cmdlet on any computer other than an Enterprise Vault server. Do not specify both the ArchiveId and SiteId parameters.

You can use Get-EVSite to obtain the site ID.

Examples
  • Get-EVRecordSettings -ArchiveId 19D...EVServer1

    Returns the records management settings for the specified archive.

  • Get-EVRecordSettings -ArchiveName msmith

    Returns the records management settings for all the archives that have the name "msmith".

  • Get-EVRecordSettings -User "Domain\user"

    Returns the records management settings for all the archives in which the user "Domain\user" has write permissions.

  • Get-EVRecordSettings -RetentionPlan RetPlanForManagers

    Returns the records management settings for all the archives to which you have applied the retention plan "RetPlanForManagers".

  • Get-EVRecordSettings -RecordType Permanent

    Returns the records management settings for all the archives to which you have applied a retention plan whose retention category has an associated record type of "Permanent".

  • Get-EVRecordSettings -RetentionCategory "Default Retention Category"

    Returns the records management settings for all the archives to which you have applied a retention plan whose retention category is "Default Retention Category".

  • Get-EVRecordSettings -ArchiveName msmith -SiteId 13E...EV.example.com

    Returns the records management settings for all the archives with the name "msmith" in the specified site.

  • Get-EVRecordSettings -RetentionPlan RetPlanForManagers | format-table -auto

    For all the archives to which you have applied the retention plan "RetPlanForManagers", returns the records management settings in tabular form.

Output

This cmdlet returns an object of type Symantec.EnterpriseVault.PowerShell.Commands.RecordSettings, which has the following properties.

Table: Get-EVRecordSettings properties

Name

Type

Description

ArchiveName

String

The name of the archive.

RetentionPlan

String

The name of the retention plan that you have applied to the archive.

RetentionCategory

String

The retention category that you have associated with the retention plan.

RecordType

String

The record type that you have associated with the retention category.

ArchiveId

String

The ID of the archive.

RetentionCategoryId

String

The ID of the retention category.

Related cmdlets