Compartir a través de


Get-CsArchivingPolicy

 

Última modificación del tema: 2012-03-23

Devuelve información acerca de las directivas de archivado de sesiones de mensajería instantánea (MI). Las directivas de archivado lo habilitan para archivar todas las sesiones de mensajería instantánea y conferencias web realizadas entre los usuarios internos o entre éstos y los usuarios externos.

Sintaxis

Get-CsArchivingPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsArchivingPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Muchas organizaciones encuentran que resulta útil llevar un archivo de todas las sesiones de mensajería instantánea en las que participan sus usuarios; otras organizaciones están obligadas por ley a llevar este tipo de archivo. Para archivar las sesiones de mensajería instantánea con Microsoft Lync Server 2010, debe seguir los dos pasos detallados a continuación. Primero, debe habilitar el archivado en el ámbito global o del sitio usando el cmdlet Set-CsArchivingConfiguration. Esto le permite archivar sesiones de mensajería instantánea; no obstante, no comienza a archivarlas automáticamente.

Para que efectivamente se guarden las transcripciones de las sesiones de mensajería instantánea debe realizar la acción 2: crear una o varias directivas de archivado de sesiones de mensajería instantánea. Estas directivas determinan cuáles serán los usuarios cuyas sesiones de mensajería instantánea se registrarán y qué tipo de sesiones se archivarán (internas o externas). Las sesiones internas de mensajería instantánea son aquellas en las que todos los participantes son usuarios autenticados que tienen cuentas de Active Directory en la organización; las externas son sesiones en las que al menos un participante es un usuario sin autenticar que no posee una cuenta de Active directory en la organización. Puede elegir archivar únicamente sesiones internas, únicamente sesiones externas, o sesiones internas y externas.

Las directivas de archivado (que se crean con el cmdlet New-CsArchivingPolicy) pueden asignarse al ámbito global o al de sitio. Además, estas directivas pueden asignarse al ámbito por usuario; esto significa que es posible crear la directiva y luego aplicarla a un usuario específico o a un conjunto específico de usuarios. Por ejemplo, podría tener una directiva global que archive las sesiones internas de mensajería instantánea para todos los usuarios. Además, se puede crear una segunda directiva: una que archive tanto las sesiones internas como las externas y aplicar la segunda directiva solamente al personal de ventas. Dado que las directivas por usuario tienen prioridad sobre las globales o de sitio, se archivarán todas las sesiones de mensajería instantánea de los miembros del personal de ventas. Otros usuarios (los usuarios que no forman parte del departamento de ventas y que no están afectados por la directiva de ventas) sólo tendrán archivadas sus sesiones internas de mensajería instantánea.

El cmdlet Get-CsArchivingPolicy es un modo de recuperar información acerca de las directivas de archivado que se han configurado para el uso en la organización. Tenga en cuenta que estas directivas sólo se exigirán si el archivado de sesiones de mensajería instantánea se habilita en el ámbito global o en el del sitio. Para determinar si el archivado de sesiones de mensajería instantánea fue habilitado o no, use el cmdlet Get-CsArchivingConfiguration.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsArchivingPolicy en forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la directiva de archivado que se quiere devolver. Para hacer referencia a la directiva global, use esta sintaxis: -Identity global. Para hacer referencia a una directiva de sitio, use una sintaxis similar a: -Identity site:Redmond. Para hacer referencia a una directiva por usuario, use una sintaxis similar a: -Identity RedmondArchivingPolicy. Si se omite este parámetro, se devolverán todas las directivas de archivado configuradas para el uso en la organización.

Filter

Opcional

Cadena de caracteres

Le permite usar caracteres comodín al indicar la directiva (o las directivas) a devolver. Por ejemplo, para devolver todas las directivas configuradas en el ámbito del sitio, use esta sintaxis: -Filter "site:*". Devuelve cualquier directiva cuya Identidad (la única propiedad que se puede filtrar) comienza con el valor de cadena "site:". Para recuperar una recopilación de todas las directivas por usuario cuya propiedad Identity comience con "Sales", use esta sintaxis: -Filter "Sales*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos de directivas de archivado de la réplica local de Almacén de administración central, en lugar del propio Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsArchivingPolicy no acepta entradas canalizadas.

Tipos de valores devueltos

Get-CsArchivingPolicydevuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Get-CsArchivingPolicy

En el Ejemplo 1 se llama a Get-CsArchivingPolicy sin parámetros. Se devuelve una recopilación de todas las directivas de archivado que están actualmente en uso en la organización.

-------------------------- Ejemplo 2 --------------------------

Get-CsArchivingPolicy -Identity site:Redmond

En el Ejemplo 2, Get-CsArchivingPolicy se usa para recuperar una directiva de archivado cuya propiedad Identity es site:Redmond. Dado que las identidades deben ser únicas, este comando siempre devolverá, como máximo, una única directiva.

-------------------------- Ejemplo 3 --------------------------

Get-CsArchivingPolicy -Filter tag:*

El comando anterior devuelve una recopilación de todas las directivas de archivado que se configuraron en el ámbito por usuario. Esto se realiza incluyendo el parámetro Filter y el valor de filtro "tag:*". Ese valor de filtro solicita a Get-CsArchivingPolicy que devuelva solo las directivas cuya identidad comience con el valor de cadena "tag:".

-------------------------- Ejemplo 4 --------------------------

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

En el Ejemplo 4 se devuelve una recopilación de todas las directivas de archivado en las que las sesiones internas de mensajería instantánea fueron deshabilitadas. Para ello, se usa primero Get-CsArchivingPolicy para recuperar una recopilación de todas las directivas de archivado actualmente en uso. A continuación, dicha recopilación se transfiere al cmdlet Where-Object. A su vez, Where-Object aplica un filtro para restringir los datos que se devuelven a las directivas en las que la propiedad ArchiveInternal es igual a False.

-------------------------- Ejemplo 5 --------------------------

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

El Ejemplo 5 es similar al Ejemplo 4, pero en este caso el comando devuelve todas las directivas de archivado en las que tanto el archivado interno como el externo están deshabilitados. Para lograrlo, se usa primero Get-CsArchivingPolicy para recuperar una recopilación de todas las directivas de archivado actualmente en uso. A continuación, dicha recopilación se canaliza a Where-Object, que selecciona las directivas en las que las propiedades ArchiveInternal y ArchiveExternal son iguales a False. El operador -and le indica a Where-Object que debe seleccionar sólo aquellas directivas que cumplen con los criterios especificados. Para seleccionar directivas que cumplan con sólo uno (o ambos) criterios especificados, use el operador –or:

Where-Object {$_.ArchiveInternal -eq $False -or $_.ArchiveExternal -eq $False}