Search <book_title>...

Veritas Enterprise Vault™ Setting up Skype for Business Archiving

Last Published: 2017-08-10

Product(s): Enterprise Vault (12.2)

Set-EVSkypeForBusinessTarget

Set-EVSkypeForBusinessTarget sets or updates the properties of a Skype for Business archiving target. If you do not specify a site ID using the -SiteId parameter and Set-EVSkypeForBusinessTarget cannot determine the site, you are prompted to enter the site ID.

Set-EVSkypeForBusinessTarget sets or updates the Skype for Business archiving target information in the Enterprise Vault directory.

To set or update the properties of a Skype for Business target, specify 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.

Also specify any new settings or replacement settings. These can include the following:

The Enterprise Vault server. 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.
The -Enabled parameter. Use $True to start exporting from the Skype for Business target to the holding folder immediately. Use $False to stop exporting.
The account details for accessing the Skype for Business target. Use -ExportLogOnCredential to specify the account details as a PSCredential object. Use -ExportLogonAccount and -Password to specify the user name as a string, and the password as a secure string.
The -RemoveExportLogonAccount parameter. When you specify this parameter, Enterprise Vault stops using the account that is assigned to the target for accessing the Skype for Business target. Enterprise Vault starts using the account that is assigned to the SMTP Archiving task.

Set-EVSkypeForBusinessTarget fails if you specify a Skype for Business archiving target that does not exist.

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

Set-EVSkypeForBusinessTarget fails if you use the -EVServer parameter to specify a new Enterprise Vault server and any of the following is true:

The new Enterprise Vault server is already hosting a Skype for Business target.
The SMTP Archiving task is not installed on the new Enterprise Vault server.

Set-EVSkypeForBusinessTarget displays a warning if you specify an archive that is incompatible with Compliance Accelerator sampling. If you intend to use Compliance Accelerator with Skype for Business, we recommend that you use an SMTP archive.

Set-EVSkypeForBusinessTarget is provided by Symantec.EnterpriseVault.PowerShell.AdminAPI.dll, which is loaded by the Enterprise Vault Management Shell.

Syntax

Set-EVSkypeForBusinessTarget [[-SiteId] <String>] [-TargetComputerFQDN] <String> [-Enabled <Boolean>] [-EVServer <String>] [-RetentionCategory <String>] [-RetentionCategoryId <String>] [-RetentionPlan <String>] [-ArchiveName <String>] [-ArchiveId <String>] [-ArchiveType <Object>] [-ExportLogOnCredential <PSCredential>] [-ExportLogonAccount <String> [-Password <SecureString>]] [-RemoveExportLogonAccount] [-AssignPermission <Boolean>] [-RevokePermission <Boolean>] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters

Table: Set-EVSkypeForBusinessTarget parameters

Parameter	Description
-SiteId	The ID of the site to which the Skype for Business archiving target belongs. 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	Whether to start exporting from the Skype for Business target to the holding folder ($True) or not ($False). If the SMTP Archiving task is running, and you enable the target, Enterprise Vault starts exporting data from the target immediately. However, if you subsequently disable the target, Enterprise Vault stops exporting new data from the target but continues to archive any remaining data in the holding folder.
-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. By default, Enterprise Vault uses the user account that is specified for the SMTP Archiving task to access the computer that is running Skype for Business Server. If you want to use a different user account, specify the account with the -ExportLogOnCredential parameter, or -ExportLogonAccount parameter. If you update the target to use a new Enterprise Vault server, Enterprise Vault uses the user account with the same name on the new server to access Skype for Business. This user account on the new server therefore requires the appropriate permissions.
-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 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 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, Set-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.
-ExportLogOnCredential	A PowerShell PSCredential object containing the logon credentials for accessing the Skype for Business target. You can create a PSCredential object using the Get-Credential cmdlet.
-ExportLogonAccount	A string containing the user name for accessing the Skype for Business target. If you specify this parameter, you must also specify the -Password parameter.
-Password	A secure string containing the password for accessing the Skype for Business target. Use this parameter with the -ExportLogonAccount parameter.
-RemoveExportLogonAccount	If specified, Enterprise Vault stops using the account that is assigned to the target for accessing the Skype for Business target. Enterprise Vault uses the account that is assigned to the SMTP Archiving task. By default, this is the Vault Service account.
-AssignPermission	Enterprise Vault can add the required permissions to the account on the Enterprise Vault server that is associated with the target: Membership of the local Administrators group. The Log On As a Service right. Full access to the SMTP holding folder. When you set this parameter to $True, Enterprise Vault adds the permissions automatically. When you set it to $False, Enterprise Vault does not add the permissions. You must add them manually. Setting this parameter stops the cmdlet from prompting you to add the permissions. If you omit this parameter, Enterprise Vault prompts you to add the permissions. Use this parameter with -ExportLogOnCredential, -ExportLogonAccount, or -EVServer.
-RevokePermission	Enterprise Vault can remove the required permissions from the account on the Enterprise Vault server that is associated with the target: Membership of the local Administrators group. The Log On As a Service right. Full access to the SMTP holding folder. When you set this parameter to $True, Enterprise Vault removes the permissions automatically. When you set it to $False, Enterprise Vault does not remove the permissions. You must remove them manually. Setting this parameter stops the cmdlet from prompting you to remove the permissions. If you omit this parameter, Enterprise Vault prompts you to remove the permissions. Use this parameter with -ExportLogOnCredential, -ExportLogonAccount, -RemoveExportLogonAccount, or -EVServer.
-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

Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ArchiveName SFBLocal -ArchiveType SMTP
Updates the archive of the Skype for Business target "skype01.example.com".
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -Enabled $True
Updates the Skype for Business target "skype01.example.com" so that it is enabled for exporting data to the holding folder.
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -EVServer 'EVServer.example.com'
Updates the Enterprise Vault server for the Skype for Business target "skype01.example.com".
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -RetentionCategory 'Standard retention' -ArchiveName SFBLocal -ArchiveType SMTP
Updates the skype01.example.com Skype for Business archiving target with new settings.
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -RetentionCategoryId 11B6...EV1004.example.com
Updates the retention category of the Skype for Business target "skype01.example.com".
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -RetentionCategoryId 11B6...EV1004.example.com -ArchiveName SFBLocal -ArchiveType SMTP
Updates the retention category and archive of the Skype for Business target "skype01.example.com".
$archiveType = (Get-EVArchive -ArchiveName "SkypeForBusiness Archive 2015_Target").ArchiveType;
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.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. Updates the settings of a Skype for Business archiving target using the stored archive type value.
$cred = Get-Credential
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnCredential $cred
Displays a Windows PowerShell credential dialog box and stores the user name and password in the $cred variable. Updates a Skype for Business archiving target so that Enterprise Vault uses the stored credentials when it connects to the Skype for Business target.
$pwd = ConvertTo-SecureString "mypassword" -AsPlainText -Force
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnAccount example\sfbadmin -Password $pwd
Stores the password in a secure string. Updates a Skype for Business archiving target so that Enterprise Vault uses the specified user name and password when it connects to the Skype for Business target.
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -RemoveExportLogonAccount
Stops using the account that is assigned to the target for accessing the Skype for Business target. Enterprise Vault uses the account that is assigned to the SMTP Archiving task. By default, this is the Vault Service account.
$cred = Get-Credential
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnCredential $cred -AssignPermission $true
Updates a Skype for Business archiving target so that Enterprise Vault uses the stored credentials when it connects to the Skype for Business target. Enterprise Vault automatically adds the required permissions to the account on the Enterprise Vault server. Enterprise Vault does not display a prompt about assigning permissions to the new account, but it does display a prompt about removing the permissions from the old account that was previously associated with the target.
$cred = Get-Credential
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnCredential $cred -RevokePermission $false
Updates a Skype for Business archiving target so that Enterprise Vault uses the stored credentials when it connects to the Skype for Business target. Enterprise Vault does not remove the required permissions from the account on the Enterprise Vault server that was previously associated with the target. Enterprise Vault displays a prompt about assigning permissions to the new account, but it does not display a prompt about removing the permissions from the old account.
$cred = Get-Credential
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnCredential $cred -AssignPermission $false -RevokePermission $true
Updates a Skype for Business archiving target so that Enterprise Vault uses the stored credentials when it connects to the Skype for Business target. Enterprise Vault does not add the required permissions to the account on the Enterprise Vault server. Enterprise Vault removes the required permissions from the account on the Enterprise Vault server that was previously associated with the target. Enterprise Vault does not display a prompt about adding or removing permissions.
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -EVServer 'EVServer.example.com' -AssignPermission $false -RevokePermission $true
Updates a Skype for Business archiving target so that it uses a new Enterprise Vault server. Enterprise Vault uses the stored credentials when it connects to the Skype for Business target. It also removes the required permissions from the account on the Enterprise Vault server that was previously associated with the target. It does not add the required permissions to the account on the new Enterprise Vault server, or display a prompt about adding or removing permissions.

Output

Set-EVSkypeForBusinessTarget returns an object of type Symantec.EnterpriseVault.Admin.EVSkypeForBusinessTarget, which has 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 the 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