Grant-CsArchivingPolicy

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Позволяет назначать политики архивации сеанса обмена мгновенными сообщениями для пользователей или групп пользователей. Эти политики позволяют архивировать все сеансы обмена мгновенными сообщениями между внутренними пользователями и между внутренними и внешними пользователями. Данный командлет впервые появился в Lync Server 2010.

Grant-CsArchivingPolicy -Identity <UserIdParameter> -PolicyName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере 1 политика архивации RedmondArchivingPolicy назначается пользователю с отображаемым именем "Ken Myer". Обратите внимание на то, что при использовании командлета Grant-CsArchivingPolicy свойство Identity относится к идентификатору пользователя, а не к идентификатору политики архивации. Вместо этого назначаемая политика определяется с помощью параметра PolicyName. В качестве значения параметра используется идентификатор политики (без префикса "tag:").

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

В примере 2 всем пользователям, у которых есть учетные записи в подразделении Redmond, назначается политика архивации RedmondArchivingPolicy. Чтобы назначить эту политику, используется командлет Get-CsUser с параметром OU, возвращающий коллекцию всех пользователей, у которых есть учетные записи в подразделении с различающимся именем "OU=Redmond,dc=litwareinc,dc=com". Эта коллекция затем передается в командлет Grant-CsArchivingPolicy , который назначает политику RedmondArchivingPolicy каждому пользователю в коллекции.

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

Команда, рассматриваемая в примере 3, назначает политику RedmondArchivingPolicy всем пользователям, работающим в Редмонде. Для выполнения этой задачи вызывается командлет Get-CsUser с параметром LdapFilter. Значение фильтра LDAP "l=Redmond" возвращает коллекцию всех пользователей, работающих в Редмонде (в языке запросов LDAP буква l — L в нижнем регистре — обозначает "locality", то есть "город"). После этого коллекция передается в командлет Grant-CsArchivingPolicy , который назначает политику RedmondArchivingPolicy каждому пользователю в коллекции.

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

В примере 4 всем пользователям в пуле регистратора atl-cs-001.litwareinc.com назначается политика RedmondArchivingPolicy. Для этого командлет Get-CsUser сначала используется для возврата всех пользователей, для которых включена поддержка Skype для бизнеса Server 2015. Эта коллекция затем передается в командлет Where-Object , который выбирает только тех пользователей, свойство RegistrarPool которых имеет значение atl-cs-001-litwareinc.com. После фильтрации коллекция передается в командлет Grant-CsArchivingPolicy , который назначает политику RedmondArchivingPolicy каждому пользователю в коллекции.

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

В примере 5 выполняется поиск всех пользователей, которым назначена политика RedmondArchivingPolicy, после чего для них назначается другая политика: NorthAmericaArchivingPolicy. Для этого используется командлет Get-CsUser , возвращающий коллекцию всех пользователей, которым разрешено использование Skype для бизнеса Server 2015. Параметр Filter и значение фильтра {ArchivingPolicy -eq "RedmondArchivingPolicy"} ограничивают возвращаемые данные учетными записями, в которых для параметра ArchivingPolicy задано значение "RedmondArchivingPolicy". После фильтрации коллекция передается в командлет Grant-CsArchivingPolicy , который назначает политику NorthAmericaArchivingPolicy каждому пользователю в коллекции.

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

Пример 6 представляет собой вариант примера 5. Однако в этом примере назначение политики RedmondArchivingPolicy отменяется для всех пользователей, которым ранее была назначена эта политика. При вызове командлета Grant-CsArchivingPolicy со параметром PolicyName, значение которого равно "$Null", все ранее назначенные каждому пользователю политики удаляются.

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

Во многих компаниях считается целесообразным вести архив сеансов обмена мгновенными сообщениями, в которых участвуют сотрудники; в других компаниях ведение подобного архива обязательно в юридическом порядке. Для архивирования сеансов обмена мгновенными сообщениями с помощью Skype для бизнеса Server 2015, необходимо выполнить два шага. Во-первых, необходимо включить архивирование на глобальном уровне и/или на уровне сайта с помощью командлета Set-CsArchivingConfiguration . Это позволит архивировать сеансы обмена мгновенными сообщениями; однако это не значит, что архивирование сеансов будет начинаться автоматически.

Для фактического сохранения записей сеансов обмена мгновенными сообщениями необходимо выполнить шаг 2: создайте один или несколько политик архивации сеанса обмена мгновенными сообщениями. Эти политики определяют, для каких пользователей выполняется запись сеансов обмена мгновенными сообщениями, а также для каких типов сеансов обмена мгновенными сообщениями (внутренние и/или внешние) выполняется архивация. Внутренние сеансы обмена мгновенными сообщениями - это сеансы, где все участники являются авторизованными пользователями, у которых есть учетные записи Active Directory в компании. Для сравнения, внешними сеансами называются сеансы, где хотя бы один участник не является авторизованным пользователем и не имеет учетной записи Active Directory в организации. Можно архивировать только внутренние сеансы, только внешние или и те, и другие.

Политики архивации можно назначать для глобальных областей или для области сайта. Кроме того, эти политики можно назначить для индивидуальной области пользователя и затем применить к отдельному пользователю или отдельному набору пользователей. Например, предположим, что ваша глобальная политика выполняет архивацию только внутренних сеансов обмена мгновенными сообщениями. В этом случае можно создать вторую политику, которая выполняет архивацию как внутренних, так и внешних сеансов, и применить эту политику только для персонала отдела продаж. Поскольку индивидуальные политики пользователя имеют приоритет перед глобальными политиками и политиками сайта, для пользователей в отделе продаж архивируются все сеансы обмена мгновенными сообщениями. Для других пользователей (пользователи, не принадлежащие в отделу продаж, на которых не влияет политика продаж) выполняется архивация только внутренних сеансов обмена мгновенными сообщениями.

Командлет Grant-CsArchivingPolicy используется для назначения индивидуальных пользовательских политик архивации для пользователя или указанного набора пользователей.

По умолчанию запускать командлет Grant-CsArchivingPolicy локально могут участники группы RTCUniversalUserAdmins. Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которые были назначены для этого командлета (включая все созданные вами роли RBAC), запустите следующую команду из командной строки Windows PowerShell:

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

 

Параметр Обязательный? Тип Описание

Identity

Обязательный

Microsoft.Rtc.Management.AD.UserIdParameter

Указывает идентификатор учетной записи пользователя, для которой необходимо назначить политику. Идентификаторы пользователей можно задать, используя один из четырех форматов: 1) SIP-адрес пользователя; 2) основной имя пользователя (UPN); 3) доменное имя и имя пользователя для входа в виде доменное имя\имя для входа (например, litwareinc\kenmyer) и 4) отображаемое имя пользователя в Active Directory (например, Петр Иванов). Идентификаторы пользователя, использующие различающееся имя пользователя в Active Directory.

Кроме того, при использовании отображаемого имени в качестве идентификатора пользователя можно использовать подстановочный знак "звездочка" (*). Например, идентификатор "* Smith" возвращает всех пользователей, отображаемое имя которых заканчивается строковым значением " Smith".

PolicyName

Обязательный

System.String

Значение "Name" политики, которую необходимо назначить. Параметр PolicyName представляет собой всего лишь идентификатор политики за исключением обозначения области "tag:". Например, политика с идентификатором tag:Redmond содержит параметр PolicyName со значением Redmond. Политика с идентификатором tag:RedmondArchivingPolicy содержит параметр PolicyName со значением RedmondArchivingPolicy.

Чтобы удалить индивидуальную пользовательскую политику, назначенную для пользователя, необходимо задать для параметра PolicyName нулевое значение:

-PolicyName $Null

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

DomainController

Необязательный

Microsoft.Rtc.Management.Deploy.Fqdn

Позволяет задать контроллер домена для подключения при назначении политики. Если этот параметр не добавлен, командлет будет использовать первый из доступных контроллеров домена.

PassThru

Необязательный

System.Management.Automation.SwitchParameter

Если параметр указан, командлет передает объект (или объекты) пользователя через конвейер Windows PowerShell. По умолчанию командлет Grant-CsArchivingPolicy не передает объекты через конвейер.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Описывает, что произойдет при выполнении команды без реального выполнения команды.

Строковое значение или объект Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Командлет Grant-CsArchivingPolicy принимает в качестве входных данных переданные по конвейеру строковые значения, представляющие удостоверение учетной записи пользователя (а также объекты пользователей).

Командлет Grant-CsArchivingPolicy не возвращает значение или объект. Вместо этого командлет назначает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.IM.ImArchivingPolicy пользователям или группам пользователей. Тем не менее при добавлении параметра PassThru командлет будет возвращать экземпляры Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

 
Показ: