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

Get-EVRBARoleMember gets the members of an Enterprise Vault RBA role from the Enterprise Vault Directory. Members can be Active Directory users, groups, or built-in security principals.

The -Identity parameter specifies the Enterprise Vault RBA role to access. You can identify an RBA role by its name, or GUID. You can also specify the role by passing a role object through the pipeline. For example, you can use Get-EVRBARole to retrieve a role object and then pass the object through the pipeline to Get-EVRBARoleMember. If you do not specify the -Identity or the -InputObject parameter, you are prompted to enter the value for -Identity.

You can specify the Enterprise Vault Directory using the -EVDirectoryServer parameter. If you do not specify the -EVDirectoryServer parameter, and Get-EVRBARoleMember cannot determine the directory, you are prompted to enter a value for -EVDirectoryServer.

If you execute Get-EVRBARoleMember from a server other than an Enterprise Vault server, it prompts for the -EVDirectoryServer parameter, unless -EVDirectoryServer is already specified as a parameter.

Permission to execute this cmdlet is restricted to the Vault Service account.

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

Syntax

Get-EVRBARoleMember [-Identity] <String> -EVDirectoryServer <String> [<CommonParameters>]

Get-EVRBARoleMember [-InputObject] <Symantec.EnterpriseVault.Admin.EVRbaRole> -EVDirectoryServer <String> [<CommonParameters>]

Parameters

Table: Get-EVRBARoleMember parameters

Parameter

Description

-Identity (required)

Specifies an Enterprise Vault RBA role by its name or GUID.

-InputObject (required)

Specifies an Enterprise Vault RBA role object. This parameter can get this object through the pipeline or you can set this parameter to an object instance.

-EVDirectoryServer (required)

Specifies the host name, fully qualified domain name, or DNS alias of an Enterprise Vault Directory server. Note that, although this parameter is required, the cmdlet determines it automatically if it can.

Examples
  • Get-EVRBARoleMember -Identity "File Server Administrator"

    Gets the members of the Enterprise Vault RBA role called "File Server Administrator" from the current Enterprise Vault Directory.

  • Get-EVRBARoleMember "File Server Administrator"

    Gets the members of the Enterprise Vault RBA role called "File Server Administrator" from the current Enterprise Vault Directory. Note that the -Identity parameter is a positioned parameter (at position 0), so this example works without it being specified.

  • Additionally, -EVDirectoryServer parameter can be specified to connect to the desired Enterprise Vault directory.

    Get-EVRBARoleMember "File Server Administrator" -EVDirectoryServer evs2.example.com

    Gets the members of the Enterprise Vault RBA role called "File Server Administrator" from the Enterprise Vault Directory identified by the -EVDirectoryServer parameter.

  • String piping example:

    "file server administrator" | Get-EVRBARoleMember

    Gets the members of the Enterprise Vault RBA role called "File Server Administrator" from the current Enterprise Vault Directory.

  • -InputObject usage example:

    $r = Get-EVRBARole "file server administrator"

    C:\PS> Get-EVRBARoleMember -InputObject $r

    Gets the members of the Enterprise Vault RBA role as specified by the input object $r from the current Enterprise Vault Directory. Note that the parameter -InputObject is a positioned parameter (again at position 0), so this example will work without it being specified.

  • EVRbaRole piping example:

    Get-EVRBARole "file server administrator" | Get-EVRBARoleMember

    Pipes the EVRbaRole object obtained from the Get-EVRBARole cmdlet to the Get-EVRBARoleMember cmdlet to get the role members for the specified identity.

Output

Get-EVRBARoleMember returns objects of the type Symantec.EnterpriseVault.Admin.EVRbaRoleMember, which has the following properties.

Table: Symantec.EnterpriseVault.Admin.EVRbaRoleMember properties

Name

Type

Description

Name

String

The NTAccount name of the member.

SID

String

The security identifier (SID) of the member.

MemberOf

String

The name of the role to which the member belongs.

Related cmdlets