Get-CsArchivingPolicy

Skype for Business Server 2015
 

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

Возвращает сведения о политиках архивирования сеансов обмена мгновенными сообщениями (IM). Политики архивирования позволяют архивировать все сеансы веб-конференций и обмена мгновенными сообщениями, имевшими место между внутренними пользователями и такими же внутренними или внешними пользователями. Данный командлет впервые появился в Lync Server 2010.

Get-CsArchivingPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsArchivingPolicy [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

В примере 1 вызывается командлет Get-CsArchivingPolicy без каких-либо параметров. В результате возвращается коллекция всех политик архивирования, в данный момент используемых в организации.

Get-CsArchivingPolicy

В примере 2 командлет Get-CsArchivingPolicy используется для получения политики с идентификатором "site:Redmond". Так как идентификаторы всегда уникальны, то данная команда всегда возвращает только одну политику.

Get-CsArchivingPolicy -Identity site:Redmond

В примере 3 извлекается коллекция всех политик архивирования, настроенных на уровне пользователя. Это выполняется включением параметра Filter со значением "tag:*". Это значение фильтра предписывает командлету Get-CsArchivingPolicy извлечь только политики, значение свойства Identity которых начинается со строкового значения "tag:".

Get-CsArchivingPolicy -Filter tag:*

В примере 4 извлекается коллекция всех политик архивирования, в которых было отключено архивирование внутренних сеансов обмена мгновенными сообщениями. Для этого сначала используется командлет Get-CsArchivingPolicy , чтобы получить коллекцию всех используемых в данный момент политик архивирования. Затем эта коллекция передается в командлет Where-Object . В свою очередь командлет Where-Object применяет фильтр, оставляющий в полученных данных только те политики, свойство ArchiveInternal которых имеет значение False.

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

Пример 5 похож на пример 4, но в данном случае команда извлекает все политики архивирования, в которых отключено архивирование как внутренних, так и внешних сеансов. Для этого сначала вызывается командлет Get-CsArchivingPolicy , чтобы получить коллекцию используемых в данный момент политик архивирования. Затем эта коллекция передается в командлет Where-Object , отбирающий только те политики, у которых свойства ArchiveInternal и ArchiveExternal имеют значение False. Использование оператора "-and" приводит к тому, что командлет Where-Object отбирает только политики, удовлетворяющие всем указанным критериям. Для отбора политик, удовлетворяющих хотя бы одному из указанных критериев, следует использовать оператор "–or":

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

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

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

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

Командлет Get-CsArchivingPolicy позволяет получить сведения о политиках архивирования, используемых в вашей организации. Помните, что данные политики применяются только в том случае, если архивирование IM-сеансов разрешено на глобальном уровне или на уровне сайта. Чтобы определить, разрешено ли архивирование сеансов, используйте командлет Get-CsArchivingConfiguration .

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

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

 

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

Filter

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

System.String

Позволяет использовать подстановочные символы при указании возвращаемых политик. Например, для получения всех политик уровня сайта используется синтаксис: -Filter "site:*". В этом случае возвращаются все политики, у которых свойство Identity (единственное свойство, к которому можно применять фильтр) начинается со строкового значения ""site:". Для получения коллекции всех индивидуальных политик, у которых свойство Identity начинается с "Sales", используйте следующий синтаксис: -Filter "Sales*".

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор возвращаемой политики архивирования. Для обращения к глобальной политике используйте синтаксис: -Identity global. Для обращения к политике сайта используйте синтаксис следующего вида: -Identity site:Redmond. Для обращения к индивидуальной политике используйте синтаксис следующего вида: -Identity RedmondArchivingPolicy. Если данный параметр опущен, то возвращаются все политики архивирования, используемые в вашей организации.

LocalStore

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

System.Management.Automation.SwitchParameter

Данные о политике архивирования берутся из локальной реплики управления, а не из самого управления.

Tenant

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

System.Guid

Глобальный уникальный идентификатор (GUID) учетной записи клиента Skype для бизнеса Online, политики архивирования которой необходимо вернуть. Пример:

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

Идентификатор каждого из своих клиентов Skype для бизнеса Online можно получить с помощью следующей команды:

Get-CsTenant | Select-Object DisplayName, TenantID

Нет. Командлет Get-CsArchivingPolicy не принимает входные данные из конвейера.

Командлет Get-CsArchivingPolicy возвращает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.Im.IMArchivingPolicy.

 
Показ: