Compartir a través de

  • Artículo

Grant-CsArchivingPolicy

 

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

Permite asignar directivas de archivado de sesiones de mensajería instantánea (MI) a usuarios o conjuntos de usuarios. Estas directivas permiten archivar todas las sesiones de MI entre usuarios internos o archivar todas las sesiones de MI entre usuarios internos y socios externos.

Sintaxis

Grant-CsArchivingPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-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 las transcripciones de las sesiones de MI, debe completar el paso 2: crear una o más directivas de archivado de sesiones de MI. Estas directivas determinan los usuarios de los que se registrarán las sesiones de MI, así como el tipo de sesiones de MI (internas o externas) que se archivará. Las sesiones de MI internas son sesiones en las que todos los participantes son usuarios autenticados con cuenta de Active Directory dentro de su organización. Por el contrario, las sesiones de MI externas son sesiones en las que al menos un participante es un usuario sin autenticar que no tiene cuenta de Active Directory dentro de su organización. Puede decidir archivar únicamente sesiones internas, externas o tanto internas como externas.

Las directivas de archivado se pueden asignar al ámbito global o al ámbito de sitio. Además, estas directivas también se pueden asignar al ámbito por usuario y, a continuación, aplicarlas a un usuario o a un conjunto de usuarios específico. Por ejemplo, supongamos que con su directiva global solo se archivan sesiones de MI internas. En tal caso, podría crear una segunda directiva, una que archive tanto las sesiones internas como las externas, y aplicarla solamente al personal de ventas. Como las directivas por usuario tienen preferencia sobre las directivas globales y de sitio, se archivarán todas las sesiones de mensajería instantánea de los miembros del personal de ventas. En el caso de otros usuarios (aquellos que no forman parte del departamento de ventas y que no están afectados por la directiva de ventas) solo se archivarán sus sesiones internas de mensajería instantánea.

El cmdlet Grant-CsArchivingPolicy se usa para asignar directivas de archivado por usuario a un usuario o a un conjunto de usuarios específico.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Grant-CsArchivingPolicy localmente: RTCUniversalUserAdmins. 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 "Grant-CsArchivingPolicy"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Indica la Identidad de la cuenta de usuario a la que debe asignarse la directiva. Las identidades de usuario pueden especificarse con cuatro formatos: 1) La dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre de dominio y nombre de inicio de sesión del usuario con formato dominio\nombre (por ejemplo, litwareinc\kenmyer); y, 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). También se puede hacer referencia a las identidades de usuario por medio del nombre distintivo de Active Directory del usuario.

Además, puede usar el asterisco (*) como carácter comodín al usar el Nombre para mostrar como la Identidad del usuario. Por ejemplo, la identidad "* Smith" devuelve todos los usuarios con un nombre para mostrar que termine con el valor de cadena de caracteres " Smith".

PolicyName

Requerido

Cadena de caracteres

"Nombre" de la directiva que se asignará. PolicyName es, simplemente, el parámetro Identity de la directiva menos "tag:", que designa el ámbito. Por ejemplo, una directiva con Identidad tag:Redmond tendrá un PolicyName igual a Redmond; una directiva con Identidad tag:RedmondArchivingPolicy tendrá un PolicyName igual a RedmondArchivingPolicy.

Para quitar una directiva por usuario asignada a un usuario, establezca PolicyName en un valor nulo:

-PolicyName $Null

DomainController

Opcional

Cadena de caracteres

Permite especificar un controlador de dominio al que conectarse para asignar la directiva. Si no se incluye este parámetro, el cmdlet usará el primer controlador de dominio disponible.

PassThru

Opcional

Parámetro modificador

Si está presente, hará que el cmdlet envíe el objeto de usuario (u objetos) a través de la canalización de Windows PowerShell. De forma predeterminada, Grant-CsArchivingPolicy no pasa objetos a través de la canalización.

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

Valor de cadena u objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsArchivingPolicy acepta entradas transferidas de valores de cadena que representen el parámetro Identity de una cuenta de usuario. Este cmdlet también acepta la entrada transferida de objetos de usuario.

Tipos de valores devueltos

Grant-CsArchivingPolicy no devuelve ningún valor ni objeto. Por el contrario, el cmdlet asigna instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.IM.ImArchivingPolicy a usuarios o grupos de usuarios. Sin embargo, si incluye el parámetro PassThru, el cmdlet devolverá instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Ejemplo

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

Grant-CsArchivingPolicy -Identity "Ken Myer" -PolicyName RedmondArchivingPolicy

En el Ejemplo 1, la directiva de archivado RedmondArchivingPolicy se asigna al usuario con nombre para mostrar "Ken Myer". Tenga en cuenta que, con Grant-CsArchivingPolicy, la propiedad Identity se refiere a la Identidad del usuario, no a la de la directiva de archivado. En su lugar, la directiva que se va a asignar se especifica mediante el parámetro PolicyName; el valor del parámetro es el parámetro Identity de la directiva (menos el prefijo "tag:" ).

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

Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

En el comando anterior, se asigna la directiva de archivado RedmondArchivingPolicy a todos los usuarios con cuenta en la unidad organizativa (OU) de Redmond. Para hacerlo, se usan Get-CsUser y el parámetro OU para devolver una colección de todos los usuarios que tengan cuentas en la OU con nombre distintivo "OU=Redmond,dc=litwareinc,dc=com". A continuación, esta colección se transfiere a Grant-CsArchivingPolicy, que asigna la directiva RedmondArchivingPolicy a cada usuario de la colección.

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

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

El comando que se muestra en el ejemplo 3 asigna la directiva RedmondArchivingPolicy a todos los usuarios que trabajan en Redmond. Para llevar a cabo esta tarea, se llama a Get-CsUser junto con el parámetro LdapFilter; el valor de filtro LDAP "l=Redmond" devuelve una colección de todos los usuarios que trabajan en la ciudad de Redmond. (En el lenguaje de consulta LDAP, una L minúscula significa "localidad" o ciudad.) A continuación, esta colección se transfiere a Grant-CsArchivingPolicy, que asigna la directiva RedmondArchivingPolicy a cada usuario de la colección.

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

Get-CsUser -Filter {RegistrarPool -eq "atl-cs-001.litwareinc.com"} | Grant-CsArchivingPolicy -PolicyName RedmondArchivingPolicy

En el ejemplo 4, se asigna la directiva RedmondArchivingPolicy a todos los usuarios hospedados en el grupo de registrador atl-cs-001.litwareinc.com. Para hacerlo, se usa primero Get-CsUser para devolver todos los usuarios habilitados para Lync Server. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona solo los usuarios con un parámetro RegistrarPool igual a atl-cs-001-litwareinc.com. Tras ello, la colección filtrada se transfiere a Grant-CsArchivingPolicy, que asigna la directiva RedmondArchivingPolicy a cada usuario de la colección.

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

Get-CsUser -Filter {ArchivingPolicy -eq "RedmondArchivingPolicy"} | Grant-CsArchivingPolicy -PolicyName "NorthAmericaArchivingPolicy"

En el ejemplo 5 se busca a todos los usuarios a los que se ha asignado la directiva RedmondArchivingPolicy y, a continuación, se asigna otra directiva a cada uno de ellos: NorthAmericaArchivingPolicy. Para ello, se usa Get-CsUser para devolver una colección de todos los usuarios habilitados para Lync Server; el parámetro Filter y el valor de filtro {ArchivingPolicy -eq "RedmondArchivingPolicy"} limitan los datos devueltos para incluir solamente las cuentas cuyo ArchivingPolicy es igual a "RedmondArchivingPolicy". A continuación, se transfiere la colección filtrada a Grant-CsArchivingPolicy, que asigna la directiva NorthAmericaArchivingPolicy a cada usuario de la colección.

-------------------------- Ejemplo 6 ------------------------

Get-CsUser -Filter {ArchivingPolicy -eq "RedmondArchivingPolicy"} | Grant-CsArchivingPolicy -PolicyName $Null

El ejemplo 6 es una variante del ejemplo 5; esta vez, sin embargo, se quita la asignación de la directiva RedmondArchivingPolicy a todos los usuarios a los que se asignó previamente: al llamar a Grant-CsArchivingPolicy con PolicyName igual a $Null, se quitan todas las directivas por usuario que se hubieran asignado previamente.