Enterprise Vault™ PowerShell Cmdlet
- Enterprise Vault PowerShell cmdlet の概要
- アーカイブ: Exchange
- アーカイブ: FSA
- アーカイブ: Skype for Business
- アーカイブ: SMTP
- バックアップ
- 分類
- データベース
- IMAP アクセス
- インデックス
- レコード管理
- 保持計画
- 役割ベースの管理
- サイトおよびサーバー
- タスクおよびサービス
- ボルトストアおよびアーカイブ
Set-EVSkypeForBusinessTarget
Set-EVSkypeForBusinessTarget は、Skype for Business アーカイブターゲットのプロパティを設定または更新します。-SiteId パラメータを使ってサイト ID を指定しない場合で、Set-EVSkypeForBusinessTarget がサイトを判別できない場合は、サイト ID を入力するように求められます。
Set-EVSkypeForBusinessTarget は、Enterprise Vault ディレクトリの Skype for Business アーカイブターゲットの情報を設定または更新します。
Skype for Business ターゲットのプロパティを設定または更新するには、Skype for Business Server が実行されているコンピュータの完全修飾ドメイン名を指定します。-TargetComputerFQDN を使用します。
メモ:
フロントエンドプールではなく、個々 の Skype for Business コンピュータの完全修飾ドメイン名を指定する必要があります。
新規または置換の設定がある場合は、それも指定します。次を含めることができます:
Enterprise Vault サーバー。-EVServer を使用します。
Skype for Business アーカイブターゲットに関連付ける保持カテゴリまたは保持計画。
保持カテゴリには、-RetentionCategory または -RetentionCategoryId を使用します。保持計画には、-RetentionPlan を使用します。
Skype for Business ターゲットに関連付けるアーカイブ。-ArchiveType で -ArchiveId または -ArchiveName を使用します。
-Enabled パラメータ。Skype for Business ターゲットから保存フォルダへのエクスポートを今すぐ開始するには、$True を使用します。エクスポートを停止するには $False を使用します。
Skype for Business ターゲットへのアクセスに使用するアカウントの詳細。アカウントの詳細を PSCredential オブジェクトとして指定するには、-ExportLogOnCredential を使用します。-ExportLogonAccount と -Password を使用して、文字列でユーザー名を指定し、安全を満たす文字列でパスワードを指定します。
-RemoveExportLogonAccount パラメータ。このパラメータを指定すると、Enterprise Vault は Skype for Business ターゲットにアクセスするためにターゲットに割り当てられているアカウントの使用を停止します。Enterprise Vault は SMTP アーカイブタスクに割り当てられているアカウントの使用を開始します。
存在しない Skype for Business アーカイブターゲットを指定すると、Set-EVSkypeForBusinessTarget は失敗します。
-Enabled パラメータを指定してすぐにアーカイブを開始すると Set-EVSkypeForBusinessTarget が失敗して、SMTP アーカイブタスクが停止します。
-EVServer パラメータを使用して新しい Enterprise Vault サーバーを指定した場合に、次のいずれかに該当するときは、Set-EVSkypeForBusinessTarget は失敗します。
新しい Enterprise Vault サーバーはすでに Skype for Business ターゲットをホストしています。
SMTP アーカイブタスクは、新しい Enterprise Vault サーバーにインストールされません。
Set-EVSkypeForBusinessTarget は、Compliance Accelerator のサンプリングと互換性がないアーカイブが指定された場合には警告を表示します。Compliance Accelerator と Skype for Business を一緒に使用する場合は、SMTP アーカイブを使用することをお勧めします。
Set-EVSkypeForBusinessTarget は、Veritas.EnterpriseVault.PowerShell.AdminAPI.dll
スナップインから利用できます。
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>]
表: Set-EVSkypeForBusinessTarget のパラメータ
パラメータ | 説明 |
---|---|
-SiteId | Skype for Business アーカイブターゲットが属しているサイトの ID。 Get-EVSite を使用して、サイト ID を取得することができます。 |
-TargetComputerFQDN (必須) | Skype for Business サーバーを実行しているコンピュータの完全修飾ドメイン名。 |
-Enabled | Skype for Business ターゲットから保存フォルダへのエクスポートを開始するか ($True)、開始しないか ($False)。 SMTP アーカイブタスクを実行している場合にターゲットを有効にすると、Enterprise Vault はターゲットのデータのエクスポートをすぐに開始します。ただし、この後ターゲットを無効にすると、Enterprise Vault はターゲットからの新しいデータのエクスポートを停止しますが、保存フォルダに残っているデータのアーカイブは続行します。 |
-EVServer | SMTP アーカイブタスクをホストする Enterprise Vault サーバー。このタスクは、Skype for Business のアーカイブ対象に関連付けられている会話を処理します。 デフォルトでは、Enterprise Vault は、SMTP アーカイブタスク用に指定したユーザーアカウントを使用して Skype for Business サーバーを実行しているコンピュータにアクセスします。別のユーザーアカウントを使う場合は、アカウントを -ExportLogOnCredential パラメータ、または -ExportLogonAccount パラメータで指定します。 新しい Enterprise Vault サーバーを使用するようにターゲットを更新する場合、Enterprise Vault は新しいサーバーで同じ名前のユーザーアカウントを使用して Skype for Business にアクセスします。そのため、新しいサーバーのこのユーザーアカウントには、適切な権限が必要です。 |
-RetentionCategory | Skype for Business ターゲットに関連付ける既存の保持カテゴリの名前。保持カテゴリを指定する場合は、任意のアーカイブの種類を使うことができます。ただし、保持計画を指定する場合は、SMTP アーカイブのみを使うことができます。 ターゲットに関連付けられているアーカイブに保持計画がある場合は、計画に関連付けられている保持カテゴリが優先的にターゲットに適用されます。 このパラメータの代わりに RetentionCategoryId パラメータを指定できます。 |
-RetentionCategoryId | Skype for Business ターゲットに関連付ける既存の保持カテゴリの ID。保持カテゴリを指定する場合は、任意のアーカイブの種類を使うことができます。ただし、保持計画を指定する場合は、SMTP アーカイブのみを使うことができます。 ターゲットに関連付けられているアーカイブに保持計画がある場合は、計画に関連付けられている保持カテゴリが優先的にターゲットに適用されます。 このパラメータの代わりに RetentionCategory パラメータを指定できます。 |
-RetentionPlan | ターゲットに関連付ける既存の保持計画の名前。この計画で定義した保持カテゴリはターゲットの会話および Enterprise Vault が会話を格納するアーカイブに割り当てられます。 次の点に注意してください。
|
-ArchiveName | Enterprise Vault がターゲットの会話をアーカイブするアーカイブ先の名前。 このパラメータとともに ArchiveType パラメータを指定する必要があります。 ArchiveName パラメータと ArchiveType パラメータの代わりに、ArchiveId パラメータを指定できます。 |
-ArchiveId | Enterprise Vault がターゲットの会話をアーカイブするアーカイブ先の ID。 このパラメータの代わりに ArchiveName パラメータと ArchiveType パラメータを指定できます。 |
-ArchiveType | Enterprise Vault がターゲットの会話をアーカイブするアーカイブ先の種類。有効なアーカイブの種類は次のとおりです。
さらに、Get-EVArchive cmdlet が返すアーカイブの種類も有効です。
Compliance Accelerator と Skype for Business を一緒に使用する場合は、SMTP アーカイブを使用することをお勧めします。 このパラメータとともに ArchiveName パラメータを指定する必要があります。 ArchiveName パラメータと ArchiveType パラメータの代わりに、ArchiveId パラメータを指定できます。 |
-ExportLogOnCredential | Skype for Business ターゲットへのアクセスに使用するログオン資格情報を含む PowerShell PSCredential オブジェクト。 Get-Credential cmdlet を使用して PSCredential オブジェクトを作成できます。 |
-ExportLogonAccount | Skype for Business ターゲットへのアクセスに使用するユーザー名を含む文字列。このパラメータを指定する場合は、-Password パラメータも指定する必要があります。 |
-Password | Skype for Business ターゲットへのアクセスに使用するパスワードを含むセキュリティで保護された文字列。このパラメータは -ExportLogonAccount パラメータとともに使用します。 |
-RemoveExportLogonAccount | このパラメータを指定すると、Enterprise Vault は Skype for Business ターゲットにアクセスするためにターゲットに割り当てられているアカウントの使用を停止します。Enterprise Vault は SMTP アーカイブタスクに割り当てられているアカウントを使用します。デフォルトでは、ボルトサービスアカウントです。 |
-AssignPermission | Enterprise Vault で、ターゲットに関連付けられている Enterprise Vault サーバーのアカウントに必要な権限を追加できます。
このパラメータを $True に設定すると、Enterprise Vault は権限を自動的に追加します。$False に設定すると、Enterprise Vault は権限を追加しません。手動で追加する必要があります。 このパラメータを設定すると、cmdlet で権限の追加を確認するメッセージが表示されません。このパラメータを省略すると、Enterprise Vault で権限の追加を確認するメッセージが表示されます。 このパラメータは、-ExportLogOnCredential、-ExportLogonAccount、-EVServer とともに使用します。 |
-RevokePermission | Enterprise Vault で、ターゲットに関連付けられている Enterprise Vault サーバーのアカウントから該当の権限を削除できます。
このパラメータを $True に設定すると、Enterprise Vault は権限を自動的に削除します。$False に設定すると、Enterprise Vault は権限を削除しません。権限を手動で削除する必要があります。 このパラメータを設定すると、cmdlet で権限の削除を求めるメッセージが表示されません。このパラメータを省略すると、Enterprise Vault で権限の削除を確認するメッセージが表示されます。 このパラメータは、-ExportLogOnCredential、-ExportLogonAccount、-RemoveExportLogonAccount、-EVServer とともに使用します。 |
-WhatIf | 指定すると、WhatIf がコマンドをテストモードで実行します。想定する変更を実装せずに確認できます。 |
-Confirm | cmdlet を実行する前に確認するように求められます。 |
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ArchiveName SFBLocal -ArchiveType SMTP
Skype for Business ターゲット "skype01.example.com" のアーカイブを更新します。
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -Enabled $True
Skype for Business ターゲット "skype01.example.com" を更新して、保存フォルダにデータをエクスポートできるようにします。
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -EVServer 'EVServer.example.com'
Skype for Business ターゲット "skype01.example.com" の Enterprise Vault サーバーを更新します。
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -RetentionCategory 'Standard retention' -ArchiveName SFBLocal -ArchiveType SMTP
Skype for Business アーカイブターゲット skype01.example.com を新しい設定で更新します。
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -RetentionCategoryId 11B6...EV1004.example.com
Skype for Business ターゲット "skype01.example.com" の保持カテゴリを更新します。
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -RetentionCategoryId 11B6...EV1004.example.com -ArchiveName SFBLocal -ArchiveType SMTP
Skype for Business ターゲット "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
Get-EVArchive を使ってアーカイブの種類を取得して、その値を変数に保存します。保存されているアーカイブタイプの値を使用して、Skype for Business アーカイブターゲットの設定を更新します。
$cred = Get-Credential
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnCredential $cred
Windows PowerShell 資格情報ダイアログボックスを表示し、ユーザー名とパスワードを $cred 変数に保存します。Skype for Business アーカイブターゲットを更新して、Enterprise Vault が Skype for Business ターゲットに接続するときに、保存されている資格情報を使用するようにします。
$pwd = ConvertTo-SecureString "mypassword" -AsPlainText -Force
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnAccount example\sfbadmin -Password $pwd
パスワードをセキュリティで保護された文字列に保存します。Skype for Business アーカイブターゲットを更新して、Enterprise Vault が Skype for Business ターゲットに接続するときに、指定したユーザー名とパスワードを使用するようにします。
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -RemoveExportLogonAccount
Skype for Business ターゲットにアクセスするためにターゲットに割り当てられているアカウントの使用を停止します。Enterprise Vault は SMTP アーカイブタスクに割り当てられているアカウントを使用します。デフォルトでは、ボルトサービスアカウントです。
$cred = Get-Credential
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnCredential $cred -AssignPermission $true
Skype for Business アーカイブターゲットを更新して、Enterprise Vault が Skype for Business ターゲットに接続するときに、保存されている資格情報を使用するようにします。Enterprise Vault は、Enterprise Vault サーバーのアカウントに必要な権限を自動的に追加します。Enterprise Vault では、新しいアカウントへの権限の割り当てに関するメッセージは表示されませんが、ターゲットに以前に関連付けられた古いアカウントからの権限の削除について確認するメッセージは表示されます。
$cred = Get-Credential
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnCredential $cred -RevokePermission $false
Skype for Business アーカイブターゲットを更新して、Enterprise Vault が Skype for Business ターゲットに接続するときに、保存されている資格情報を使用するようにします。Enterprise Vault は、ターゲットに以前関連付けられた Enterprise Vault サーバーのアカウントから必要な権限を削除しません。Enterprise Vault は、新しいアカウントへの権限の割り当てに関するメッセージを表示しますが、古いアカウントからの権限の削除について確認するメッセージは表示しません。
$cred = Get-Credential
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -ExportLogOnCredential $cred -AssignPermission $false -RevokePermission $true
Skype for Business アーカイブターゲットを更新して、Enterprise Vault が Skype for Business ターゲットに接続するときに、保存されている資格情報を使用するようにします。Enterprise Vault は、Enterprise Vault サーバーのアカウントに必要な権限を追加しません。Enterprise Vault は、ターゲットに以前関連付けられた Enterprise Vault サーバーのアカウントから該当の権限を削除します。Enterprise Vault は、権限の追加または削除について確認するメッセージを表示しません。
Set-EVSkypeForBusinessTarget -TargetComputerFQDN "skype01.example.com" -EVServer 'EVServer.example.com' -AssignPermission $false -RevokePermission $true
Skype for Business アーカイブターゲットを更新して、新しい Enterprise Vault サーバーを使用するようにします。Enterprise Vault は、Skype for Business ターゲットに接続するときに、保存されている資格情報を使用します。また、ターゲットに以前関連付けられた Enterprise Vault サーバーのアカウントから該当の権限を削除します。新しい Enterprise Vault サーバーのアカウントに必要な権限を追加したり、権限の追加または削除について確認するメッセージを表示することはありません。
Set-EVSkypeForBusinessTarget は、次のプロパティを持つタイプ Symantec.EnterpriseVault.Admin.EVSkypeForBusinessTarget のオブジェクトを返します。
表: Symantec.EnterpriseVault.Admin.SkypeForBusinessTarget のプロパティ
名前 | 種類 | 説明 |
---|---|---|
SiteId | 文字列 | Skype for Business アーカイブターゲットが属しているサイトの ID。 |
TargetComputerFQDN | 文字列 | Skype for Business サーバーを実行しているコンピュータの完全修飾ドメイン名。 |
EVServer | 文字列 | SMTP アーカイブタスクをホストする Enterprise Vault サーバー。このタスクは、Skype for Business のアーカイブ対象に関連付けられている会話を処理します。 |
SMTPTaskId | 文字列 | Skype for Business データをアーカイブする SMTP アーカイブタスクの ID。 |
RetentionCategory | 文字列 | Skype for Business ターゲットに関連付ける保持カテゴリの名前。Enterprise Vault が「(From Plan)」という語句を保持カテゴリ名に追加した場合、保持計画はターゲットに関連付けられたアーカイブに適用されています。Enterprise Vault は保持計画で定義した保持カテゴリを会話に適用します。アーカイブに保持計画を割り当てていない場合、有効な保持カテゴリは、 ターゲットのプロパティで定義されている保持カテゴリになります。 |
RetentionCategoryId | 文字列 | Skype for Business ターゲットに関連付ける保持カテゴリの ID。 ターゲットに関連付けられているアーカイブに保持計画がある場合は、計画に関連付けられている保持カテゴリが優先的にターゲットに適用されます。 |
ArchiveName | 文字列 | Skype for Business ターゲットに関連付けるアーカイブの名前。 |
ArchiveId | 文字列 | Skype for Business ターゲットに関連付けるアーカイブの ID。 |
ArchiveType | オブジェクト | Skype for Business ターゲットに関連付けるアーカイブの種類。 |
ArchiveSamplingReady | Boolean | Skype for Business ターゲットに関連付けられているアーカイブが Compliance Accelerator のサンプリングと互換性があるか (True)、互換性がないか (False)。 |
VaultStoreName | 文字列 | Skype for Business ターゲットに関連付けるボルトストアの名前。 |
有効化 | Boolean | 保存フォルダへのデータのエクスポートで Skype for Business ターゲットが有効になっているか (True)、有効になっていないか (False)。 |
ExportLogOnAccount | 文字列 | Enterprise Vault が Skype for Business ターゲットにアクセスするために使用するアカウント。デフォルトでは、SMTP アーカイブタスクに割り当てられているアカウントが使用されます。必要に応じ、Set-EVSkypeforBusinessTarget を使用して、ターゲットごとに異なるアカウントを指定できます。 |
Get-EVSkypeForBusinessTargetを参照してください。
New-EVSkypeForBusinessTargetを参照してください。
Remove-EVSkypeForBusinessTargetを参照してください。