Set-CsArchivingPolicy
Última modificación del tema: 2012-03-26
Modifica una directiva de archivado de mensajería instantánea (IM) existente. Una directiva de archivado proporciona la capacidad de archivar todas las sesiones de mensajería instantánea y conferencias que tienen lugar entre usuarios internos. También se pueden archivar sesiones que tienen lugar entre usuarios internos y socios federados.
Sintaxis
Set-CsArchivingPolicy [-Identity <XdsIdentity>] [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsArchivingPolicy [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Muchas organizaciones consideran útil mantener un archivo de todas las sesiones de MI en las que participan sus usuarios; otras organizaciones tienen la obligación legal de mantener este tipo de archivo. Para archivar sesiones de MI con Microsoft Lync Server 2010, debe seguir dos pasos. Primero, habilite el archivado en el ámbito global o de sitio, usando el cmdlet Set-CsArchivingConfiguration. Esta acción permite archivar sesiones de MI, pero no empieza a archivar automáticamente las sesiones.
Para guardar transcripciones de las sesiones de mensajería instantánea, se debe realizar el paso dos: crear una o más directivas de archivado que determinen los usuarios cuyas sesiones de mensajería instantánea se grabarán y qué tipo de sesiones de mensajería instantánea (internas y/o externas) se archivarán. Las sesiones de mensajería instantánea internas son aquellas en las que todos los participantes son usuarios autenticados que tienen cuentas de Active Directory dentro de la organización. Las sesiones de mensajería instantánea externas son sesiones en las que al menos un participante es un usuario no autenticado que no dispone de una cuenta Active Directory en la organización. Puede decidir archivar únicamente sesiones internas, externas o tanto internas como externas.
Las directivas de archivado (creadas con el cmdlet New-CsArchivingPolicy) pueden asignarse al sitio global o al ámbito del sitio. Además, estas directivas se pueden asignar al ámbito de usuario; de modo que las directivas se pueden crear para luego aplicarlas a un usuario o a un grupo de usuarios definido en concreto. Por ejemplo, es posible tener una directiva global que archive las sesiones de mensajería instantánea internas de todos los usuarios. Además, se puede crear una segunda directiva, una que archive tanto las sesiones internas como las externas y, a continuación, aplicarla solamente al personal de ventas. Ya que las directivas del ámbito de usuario tienen prioridad sobre las directivas globales y de sitio, se archivarán todas las sesiones de MI de los miembros del personal de ventas. Otros usuarios (aquéllos que no forman parte del departamento de ventas y que no están afectados por la directiva de ventas) solo tendrán sus sesiones internas de mensajería instantánea archivadas.
El cmdlet Set-CsArchivingPolicy permite modificar los valores de propiedad de cualquier directiva de archivado de sesiones de mensajería instantánea que se esté utilizando en la organización.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsArchivingPolicy localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsArchivingPolicy"}
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único de la directiva de archivado que se va a modificar. Las directivas de archivado pueden configurarse en los ámbitos global, de sitio o de cada usuario. Para modificar la directiva global, use la siguiente sintaxis: -Identity global. Para modificar una directiva de sitio, use la sintaxis siguiente: -Identity site:Redmond. Para modificar una directiva de usuario, use la sintaxis siguiente: -Identity SalesArchivingPolicy. Si no se especifica este parámetro, se modificará la directiva global. No se pueden utilizar caracteres comodín al especificar una Identidad. |
Instance |
Opcional |
Objeto IMArchivingPolicy |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. |
ArchiveExternal |
Opcional |
Booleano |
Indica si se archivan las sesiones de mensajería instantánea externas. (Una sesión de mensajería instantánea externa es aquella en la que al menos uno de los participantes es un usuario autenticado que no tiene una cuenta de Active Directory en su organización). El valor predeterminado es False, lo que significa que las sesiones de mensajería instantánea que incluyen usuarios externos no se archivan. |
ArchiveInternal |
Opcional |
Booleano |
Indica si se archivan las sesiones de mensajería instantánea internas. (Una sesión de mensajería instantánea interna es aquella en la que todos los participantes son usuarios autenticados que tienen cuentas de Active Directory dentro de la organización). El valor predeterminado es False, lo que significa que las sesiones de mensajería instantánea internas no se archivan. |
Description |
Opcional |
Cadena de caracteres |
Permite a los administradores proporcionar más texto relacionado con la directiva. Por ejemplo, la propiedad Description puede utilizarse para detallar a qué usuarios deberá aplicarse la directiva. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan surgir al ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.IM.IMArchivingPolicy. Remove-CsArchivingPolicy acepta la entrada transferida de objetos de directiva de archivado.
Tipos de valores devueltos
Set-CsArchivingPolicy no devuelve ningún valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Policy.IM.IMArchivingPolicy.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsArchivingPolicy -Identity global -ArchiveInternal $True
En este ejemplo, Set-CsArchivingPolicy se utiliza para modificar la directiva de archivado global. En este caso, la propiedad ArchiveInternal está establecida en True.
-------------------------- Ejemplo 2 --------------------------
Get-CsArchivingPolicy | Set-CsArchivingPolicy -ArchiveInternal $True
El ejemplo 2 es una variación del comando mostrado en el ejemplo 1. No obstante, en este caso todas las directivas de archivado de la organización están configuradas para permitir el archivado de sesiones de mensajería instantánea. Para ello, el comando llama en primer lugar a Get-CsArchivingPolicy para devolver una colección de todas las directivas de archivado de sesiones de mensajería instantánea que se están utilizando actualmente. A continuación, dicha colección se transfiere a Set-CsArchivingPolicy, que establece la propiedad ArchiveInternal de cada una de las directivas en True.
Vea también
Otros recursos
Get-CsArchivingPolicy
Grant-CsArchivingPolicy
New-CsArchivingPolicy
Remove-CsArchivingPolicy