Enterprise Vault™ PowerShell Cmdlets

Last Published:
Product(s): Enterprise Vault (12.4)
  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.  
      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-EVArchivePermission
    4.  
      Get-EVVaultStore
    5.  
      Get-EVVaultStorePartition
    6.  
      Remove-EVArchive
    7.  
      Remove-EVArchivePermission
    8.  
      Set-EVArchive
    9.  
      Set-EVArchivePermission
    10.  
      Start-PartitionRollover

Get-EVIMAPUserSettings

Get-EVIMAPUserSettings gets the IMAP/SMTP client settings for the given user SID.

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

Syntax

Get-EVIMAPUserSettings -SID [-FullFormatUserName [<SwitchParameter>]] [<CommonParameters>]

Parameters

Table: Get-EVIMAPUserSettings parameters

Parameter

Description

-SID (required)

The SID (security identifier) of the Active Directory user whose IMAP settings you want to display.

-FullFormatUserName

If specified, causes the output from the cmdlet to show the full-format version of the user's account name for every archive that the user can access. This full-format version appends an identifier to the user's logon name; for example, EMEA\JohnDoe\1962. If you omit the parameter, the output omits the identifier from the logon name for the user's default IMAP archive, but it shows the identifier for any other archives that the user can access.

For more information, see the Setting up IMAP guide.

Examples
  • Get-EVIMAPUserSettings S-1-5-21-750406912-2207124990-322363385-3682

    Returns the IMAP/SMTP server settings for the archives that the user represented by the SID parameter has access to.

  • Get-EVIMAPUserSettings S-1-5-21-750406912-2207124990-322363385-3682 -FullFormatUserName

    Returns the IMAP/SMTP server settings for the archives that the user represented by the SID parameter has access to. The settings for the default IMAP archive shows an identifier as part of the user name. Without the -FullFormatUserName parameter, the identifier is hidden for the default IMAP archive, and only shown for additional archives the user can access. For more information on the identifier in the user name, see the Setting up IMAP guide.

Output

Table: Get-EVIMAPUserSettings properties lists the properties that are available.

Table: Get-EVIMAPUserSettings properties

Name

Type

Description

Archivename

String

The name of the user's archive.

ArchiveOwner

Boolean

Indicates whether the user is the owner of the archive. Possible values: $true (user owns the archive), $false (user does not own the archive).

ArchiveType

String

The type of archive. Possible values: "Exchange", "Internet Mail".

IMAP_Connection_Security

String

The security to use for the IMAP connection.

Both STARTTLS and TLS protocols are supported.

IMAP_Password

String

Specifies which account's password to use when connecting to the archive.

IMAP_Port

Int32

The port number to use for the IMAP connection.

IMAP_Server

String

The IMAP server to which to connect.

IMAP_UserName

String

The account name to use when connecting to the IMAP server.

When the -FullFormatUserName parameter is set, the settings for the default IMAP archive show an identifier as part of the user name. Without the -FullFormatUserName parameter, the identifier is hidden for the default IMAP archive, and only shown for additional archives the user can access.

Note:

If the default IMAP archive is deleted, no new default archive is selected. The user name for logging onto the remaining archives always includes an identifier.

ReadyForIMAP

Boolean

Indicates whether the metadata store has been built for the archive. Possible values: $true (the metadata store has been built), $false (the metadata store has not yet been built). Internet mail archives always have a metadata store, so ReadyForIMAP is always true for Internet mail archives.

SMTP_Connection_Security

String

The type of security to use for the SMTP connection.

Both STARTTLS and TLS protocols are supported.

SMTP_Password

String

Possible values: "SMTP account username" (the SMTP server requires authentication), "Not applicable" (the SMTP server does not require authentication).

SMTP_Port

Int32

The port to use for the SMTP connection.

SMTP_Server

String

The SMTP server to which to connect.

SMTP_UserName

String

If the SMTP server requires authentication this string contains "SMTP account username".

WindowsUser

String

The Windows account to use to connect to the IMAP server.

Related cmdlets