Get-CsArchivingPolicy

 

トピックの最終更新日: 2012-03-23

インスタント メッセージング (IM) セッションのアーカイブ ポリシーに関する情報を戻します。アーカイブ ポリシーにより、内部ユーザー間で、または内部ユーザーと外部ユーザーの間で実行されるすべての IM セッションおよび Web 会議セッションをアーカイブできます。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)

構文

Get-CsArchivingPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>

Get-CsArchivingPolicy [-Filter <String>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

例 1

例 1 では、パラメーターを指定せずに Get-CsArchivingPolicy コマンドレットを呼び出しています。これにより、組織で現在使用中のすべてのアーカイブ ポリシーのコレクションを戻します。

Get-CsArchivingPolicy

例 2

例 2 では、Get-CsArchivingPolicy コマンドレットを使用して site:Redmond という ID を持つアーカイブ ポリシーを戻します。ID は一意である必要があるため、このコマンドによって戻されるポリシーは最大でも常に 1 つです。

Get-CsArchivingPolicy -Identity site:Redmond

例 3

例 3 では、ユーザーごとのスコープで構成されているすべてのアーカイブ ポリシーのコレクションを戻します。このコマンドは、Filter パラメーターとフィルター値 "tag:*" を指定して実行されます。Get-CsArchivingPolicy コマンドレットは、そのフィルター値に基づいて、ID が文字列値 "tag:" で始まるポリシーのみを戻します。

Get-CsArchivingPolicy -Filter tag:*

例 4

例 4 では、内部 IM セッションのアーカイブが無効になっているすべてのアーカイブ ポリシーのコレクションを戻します。この操作を実行するため、まず Get-CsArchivingPolicy コマンドレットを使用して現在使用中のすべてのアーカイブ ポリシーのコレクションを戻します。次に、このコレクションは、Where-Object コマンドレットにパイプ処理されます。Where-Object コマンドレットで、戻されるデータを ArchiveInternal プロパティが False に等しいポリシーに制限するフィルターを適用します。

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False}

例 5

例 5 は例 4 と類似していますが、この場合は、コマンドを実行すると、内部と外部の両方のアーカイブが無効になっているアーカイブ ポリシーすべてが戻されます。この操作を実行するために、まず Get-CsArchivingPolicy コマンドレットを使用して現在使用中のすべてのアーカイブ ポリシーのコレクションを戻します。次に、このコレクションを Where-Object コマンドレットにパイプ処理して、ArchiveInternal と ArchiveExternal の両方のプロパティが False に等しいポリシーのみ取得します。Where-Object コマンドレットは、-and 演算子に基づいて、指定されたすべての条件を満たすポリシーのみを選択します。指定された条件の 1 つのみ (または両方) を満たすポリシーを取得するには、–or 演算子を使用します。

Get-CsArchivingPolicy | Where-Object {$_.ArchiveInternal -eq $False -and $_.ArchiveExternal -eq $False}

解説

組織内のユーザーが参加するすべての IM セッションのアーカイブを保持しておくことは、多くの組織において有効です。また、こういったアーカイブを保持することが法律で義務付けられている組織もあります。Lync Server で IM セッションをアーカイブするためには、2 つの手順を実行する必要があります。まず、Set-CsArchivingConfiguration コマンドレットを使用して、グローバル スコープまたはサイト スコープでアーカイブを有効にする必要があります。これにより、IM セッションをアーカイブできるようになります。ただし、これらのセッションのアーカイブは、自動的には開始されません。

代わりに IM セッションの内容を実際に保存するには、2 番目の手順として、IM セッションのアーカイブ ポリシーを 1 つ以上作成する必要があります。これらのポリシーにより、IM セッションが記録されるユーザー、およびアーカイブする IM セッションのタイプ (内部または外部) を判断します。内部 IM セッションは、参加者すべてが、組織内で Active Directory アカウントを持つ認証済みユーザーで構成されているセッションです。外部 IM セッションは、参加者の少なくとも 1 人が、組織内で Active Directory アカウントを持っておらず、認証されていないユーザーになっているセッションです。内部セッションのみ、外部セッションのみ、または内部セッションと外部セッションの両方をアーカイブするよう選択できます。

アーカイブ ポリシー (New-CsArchivingPolicy コマンドレットを使用して作成) は、グローバル サイトまたはサイト スコープに割り当てることができます。またこれらのポリシーは、ユーザーごとのスコープに割り当てることもできます。つまり、1 つのポリシーを作成して、特定のユーザーまたは特定のユーザー グループに適用することができます。たとえば、すべてのユーザーの内部 IM セッションをアーカイブするグローバル ポリシーがあるとします。加えて、内部と外部の両方のセッションをアーカイブする 2 番目のポリシーを作成して、そのポリシーを営業スタッフに適用することができます。ユーザーごとのポリシーはグローバルおよびサイト ポリシーよりも優先されるため、その営業スタッフのメンバーは、自分たちの IM セッションをすべてアーカイブすることになります。他のユーザー (営業部門に所属していないため、営業に関するポリシーの影響を受けないユーザー) は、内部 IM セッションのみがアーカイブされます。

Get-CsArchivingPolicy コマンドレットにより、組織用に構成されているアーカイブ ポリシーに関する情報を戻すことができます。IM セッションのアーカイブがグローバルまたはサイト スコープで有効になっている場合にのみ、これらのポリシーが適用される点に注意してください。IM セッションのアーカイブが有効になっているかどうかを判断するには、Get-CsArchivingConfiguration コマンドレットを使用します。

このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが、Get-CsArchivingPolicy コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsArchivingPolicy"}

パラメーター

パラメーター 必須かどうか 説明

Filter

省略可能

System.String

ポリシー (複数可) を戻すよう指示するときに、ワイルドカードを使用できるようにします。たとえば、サイト スコープで構成されているすべてのポリシーを戻すには、次の構文を使用します。-Filter "site:*"。これにより、ID (フィルター処理できる唯一のプロパティ) が文字列 "site:" で始まるポリシーが戻されます。ID が "Sales" で始まるすべてのユーザーごとのポリシーのコレクションを戻すには、次の構文を使用します。-Filter "Sales*"。

Identity

省略可能

Microsoft.Rtc.Management.Xds.XdsIdentity

戻されるアーカイブ ポリシーの一意の識別子。グローバル ポリシーを参照するには、次の構文を使用します。-Identity global。サイト ポリシーを参照するには、次のような構文を使用します。-Identity site:Redmond。ユーザーごとのポリシーを参照するには、次のような構文を使用します。-Identity RedmondArchivingPolicy。このパラメーターを省略すると、組織用に構成されたアーカイブ ポリシーすべてが戻されます。

LocalStore

省略可能

System.Management.Automation.SwitchParameter

中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカからアーカイブ ポリシーのデータを取得します。

Tenant

省略可能

System.Guid

アーカイブ ポリシーが返される Office 365 テナント アカウントのグローバル一意識別子 (GUID) です。次に例を示します。

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

次のコマンドを実行することにより、テナントの各々についてテナント ID を返すことができます。

Get-CsTenant | Select-Object DisplayName, TenantID

Windows PowerShell のリモート セッションを使用していて、Lync Online 15 のみに接続している場合、Tenant パラメーターを含める必要はありません。代わりに、接続情報に基づいてテナント ID が自動的に入力されます。Tenant パラメーターはハイブリッド展開で主に使用されます。

入力の種類

なし。Get-CsArchivingPolicy コマンドレットは、パイプ処理された入力を受け入れません。

戻り値の種類

Get-CsArchivingPolicy コマンドレットを実行すると、Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy オブジェクトのインスタンスが戻されます。