Enterprise Vault™ Setting up Skype for Business Archiving

Last Published:
Product(s): Enterprise Vault (12.3)
  1. About this guide
    1.  
      Introducing this guide
    2. Where to get more information about Enterprise Vault
      1.  
        Enterprise Vault training modules
  2. Introducing Skype for Business Archiving
    1.  
      About Skype for Business Archiving
    2.  
      Skype for Business Archiving overview
    3.  
      About Skype for Business Archiving licensing
  3. Installing Skype for Business Archiving
    1.  
      About installing Enterprise Vault Skype for Business Archiving components
  4. Configuring Skype for Business Archiving
    1.  
      Steps to configure Skype for Business Archiving
    2.  
      Managing data in the Skype for Business archiving database
    3.  
      Creating the archive
    4.  
      Roles-based administration (RBA) and Skype for Business Archiving
    5.  
      Assigning the permissions required for exporting conversations from Skype for Business
    6.  
      Configuring Skype for Business Archiving using the wizard
    7. Configuring Skype for Business Archiving manually
      1. Configuring an SMTP Archiving task
        1.  
          About the SMTP holding folder
        2.  
          Changing the location of the holding folder in a site where only Skype for Business Archiving is configured
        3.  
          Changing the location of the holding folder in a site where both Skype for Business Archiving and SMTP Archiving are configured
        4.  
          Keeping safety copies of archived conversations
        5.  
          Archiving task summary reports
      2. Configuring retention categories
        1. How to plan settings for retention categories
          1.  
            About retention plans
      3. Adding a new Skype for Business Archiving target
        1.  
          Adding a new Skype for Business Archiving target using the Administration Console
        2.  
          Adding a new Skype for Business Archiving target using PowerShell
    8. Editing a Skype for Business Archiving target
      1.  
        Editing a Skype for Business Archiving target using the Administration Console
      2.  
        Editing a Skype for Business Archiving target using PowerShell
    9. Listing available Skype for Business Archiving targets
      1.  
        Listing available Skype for Business Archiving targets using the Administration Console
      2.  
        Listing available Skype for Business Archiving targets using PowerShell
    10. Deleting Skype for Business Archiving targets
      1.  
        Disabling a Skype for Business target
      2.  
        Checking that all exported conversations have been archived
      3.  
        Deleting Skype for Business archiving targets
    11.  
      Monitoring Skype for Business processes
    12.  
      Generating usage reports for Skype for Business Archiving
    13. Changing the Enterprise Vault server used to archive Skype for Business conversations
      1.  
        About permissions
      2.  
        Updating the Skype for Business target to use a new Enterprise Vault server
      3.  
        Stopping the SMTP Archiving task on the old Enterprise Vault server
    14. Using Compliance Accelerator or Discovery Accelerator with Skype for Business Archiving
      1.  
        Ensuring that the Accelerator products can get the SIP addresses of the Skype for Business users
      2.  
        Ensuring that Compliance Accelerator can determine the correct direction of travel of the Skype for Business conversations
  5. Appendix A. PowerShell cmdlets for Skype for Business
    1.  
      About the Skype for Business cmdlets
    2.  
      Running the Skype for Business cmdlets
    3.  
      Get-EVSkypeForBusinessTarget
    4.  
      New-EVSkypeForBusinessTarget
    5.  
      Remove-EVSkypeForBusinessTarget
    6.  
      Set-EVSkypeForBusinessTarget

New-EVSkypeForBusinessTarget

New-EVSkypeForBusinessTarget adds a new Skype for Business archiving target. If you do not specify a site ID using the -SiteId parameter and New-EVSkypeForBusinessTarget cannot determine the site, you are prompted to enter the site ID.

New-EVSkypeForBusinessTarget adds information about the Skype for Business archiving target to the Enterprise Vault directory.

To add a new Skype for Business target, specify the following:

  • The fully qualified domain name of the computer running Skype for Business Server. Use -TargetComputerFQDN.

    Note:

    You must specify the fully qualified domain name of an individual Skype for Business computer, and not a Front End pool.

  • Whether to start exporting from the Skype for Business target to the holding folder immediately. Use -Enabled.

  • The Enterprise Vault server that processes the target. Use -EVServer.

  • The retention category or retention plan to associate with the Skype for Business archiving target.

    For the retention category, use -RetentionCategory or -RetentionCategoryId. For the retention plan, use -RetentionPlan.

  • The archive to associate with the Skype for Business target. Use -ArchiveId, or -ArchiveName with -ArchiveType.

New-EVSkypeForBusinessTarget fails if you specify a Skype for Business archiving target that already exists.

New-EVSkypeForBusinessTarget fails if you specify the -Enabled parameter to start archiving immediately, and the SMTP Archiving task is stopped.

New-EVSkypeForBusinessTarget displays a warning if you specify an archive that is incompatible with Compliance Accelerator sampling.

New-EVSkypeForBusinessTarget is provided by the snap-in Symantec.EnterpriseVault.PowerShell.AdminAPI.dll.

Syntax

New-EVSkypeForBusinessTarget [[-SiteId] <String>] [-TargetComputerFQDN] <String> [-Enabled <Boolean>] [-EVServer <String>] [-RetentionCategory <String>] [-RetentionCategoryId <String>] [-RetentionPlan <String>] [-ArchiveName <String>] [-ArchiveId <String>] [-ArchiveType <Object>] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters

Table: New-EVSkypeForBusinessTarget parameters

Parameter

Description

-SiteId

The ID of the site to which you want to add the Skype for Business archiving target.

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

-TargetComputerFQDN (required)

The fully qualified domain name of the computer running Skype for Business Server.

-Enabled (required)

Whether to start exporting from the Skype for Business target to the holding folder immediately ($True) or not ($False).

If you create the target with the -Enabled parameter set to $False, you must set the parameter to $True using Set-EVSkypeForBusinessTarget before export begins.

-EVServer

The Enterprise Vault server that hosts the SMTP Archiving task. This task processes conversations that are associated with the Skype for Business archiving target.

-RetentionCategory

The name of an existing retention category to be associated with the Skype for Business target. If you specify a retention category, you can use any archive type. However, if you specify a retention plan, you can only use an SMTP archive.

If the archive that is associated with the target has a retention plan, the retention category that is associated with the plan takes precedence and is applied to the target.

You can specify the RetentionCategoryId parameter instead of this parameter.

-RetentionCategoryId

The ID of the retention category to be associated with the Skype for Business target. If you specify a retention category, you can use any archive type. However, if you specify a retention plan, you can only use an SMTP archive.

If the archive that is associated with the target has a retention plan, the retention category that is associated with the plan takes precedence and is applied to the target.

You can specify the RetentionCategory parameter instead of this parameter.

-RetentionPlan

The name of an existing retention plan to be associated with the target. The retention category that you have defined in the plan is assigned to the target's conversations and to the archive in which Enterprise Vault stores them. If this archive already has a retention plan, New-EVSkypeForBusinessTarget cannot associate a new plan with the target.

Note that you cannot do either of the following:

  • Specify both a retention category and a retention plan.

  • Assign a retention plan to a non-SMTP archive.

-ArchiveName

The name of the archive in which Enterprise Vault archives the conversations from the target.

You must specify the ArchiveType parameter with this parameter.

You can specify the ArchiveId parameter instead of the ArchiveName parameter and the ArchiveType parameter.

-ArchiveId

The ID of the archive in which Enterprise Vault archives the conversations from the target.

You can specify the ArchiveName parameter and the ArchiveType parameter instead of this parameter.

-ArchiveType

The type of archive in which Enterprise Vault archives the conversations from the target.

The valid archive types are:

  • DominoJournal

  • DominoMailbox

  • ExchangeJournal

  • ExchangeMailbox

  • ExchangePublicFolder

  • FileSystem

  • InternetMail

  • Shared

  • SharePoint

  • SharePointStructured

  • SMTP

In addition, the archive types that the Get-EVArchive cmdlet returns are also valid:

  • ARCHIVE_TYPE_DOMINO_JOURNAL

  • ARCHIVE_TYPE_DOMINO_MAILBOX

  • ARCHIVE_TYPE_FILE_SYSTEM

  • ARCHIVE_TYPE_INTERNETMAIL

  • ARCHIVE_TYPE_JOURNAL

  • ARCHIVE_TYPE_MAILBOX

  • ARCHIVE_TYPE_PUBLIC_FOLDER

  • ARCHIVE_TYPE_SHARED

  • ARCHIVE_TYPE_SHAREPOINT

  • ARCHIVE_TYPE_SMTP

If you intend to use Compliance Accelerator with Skype for Business, we recommend that you use an SMTP archive.

You must specify the ArchiveName parameter with this parameter.

You can specify the ArchiveId parameter instead of the ArchiveName parameter and the ArchiveType parameter.

-WhatIf

If specified, WhatIf runs the command in test mode. You can see the expected changes without implementing them.

-Confirm

Prompts you for confirmation before running the cmdlet.

Examples
  • New-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -Enabled $True -EVServer 'EVServer.example.com' -RetentionCategory 'Standard retention' -ArchiveName SFBLocal -ArchiveType SMTP

    Adds skype01.example.com as a new Skype for Business archiving target.

  • $archiveType = (Get-EVArchive -ArchiveName "SkypeForBusiness Archive 2015_Target").ArchiveType;

    New-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -Enabled $True -EVServer 'EVServer.example.com' -RetentionCategory "SkypeForBusiness Retention" -ArchiveName "SkypeForBusiness Archive 2015_Target" -ArchiveType $archiveType

    Uses Get-EVArchive to retrieve the archive type, and then stores the value in a variable. Adds a new Skype for Business archiving target using the stored archive type value.

Output

New-EVSkypeForBusinessTarget returns an object of type Symantec.EnterpriseVault.Admin.EVSkypeForBusinessTarget, which comprises the following properties:

Table: Symantec.EnterpriseVault.Admin.SkypeForBusinessTarget properties

Name

Type

Description

SiteId

String

The ID of the site to which the Skype for Business archiving target belongs.

TargetComputerFQDN

String

The fully qualified domain name of the computer running Skype for Business Server.

EVServer

String

The Enterprise Vault server that hosts the SMTP Archiving task. This task processes conversations that are associated with the Skype for Business archiving target.

SMTPTaskId

String

The ID of the SMTP Archiving task that archives Skype for Business data.

RetentionCategory

String

The name of the retention category that is associated with the Skype for Business target. If Enterprise Vault appends the words "(From Plan)" to the retention category name, a retention plan has been applied to the archive that is associated with the target. Enterprise Vault applies the retention category that is defined in the plan to the conversations. If you have not assigned a retention plan to the archive, the effective retention category is the one that is defined in the target properties.

RetentionCategoryId

String

The ID of the retention category that is associated with the Skype for Business target.

If the archive that is associated with the target has a retention plan, the retention category that is associated with the plan takes precedence and is applied to the target.

ArchiveName

String

The name of the archive that is associated with the Skype for Business target.

ArchiveId

String

The ID of the archive that is associated with the Skype for Business target.

ArchiveType

Object

The type of archive that is associated with the Skype for Business target.

ArchiveSamplingReady

Boolean

Whether the archive that is associated with the Skype for Business target is compatible with Compliance Accelerator sampling (True) or not (False).

VaultStoreName

String

The name of the vault store that is associated with the Skype for Business target.

Enabled

Boolean

Whether the Skype for Business target is enabled for exporting data to the holding folder (True) or not (False).

ExportLogOnAccount

String

The account that Enterprise Vault uses to access the Skype for Business target. By default, the account that is assigned to the SMTP Archiving task is used. You can specify a different account for each individual target using Set-EVSkypeforBusinessTarget if required.

Related cmdlets