Get-CsEffectivePolicy

Skype for Business Server 2015
 

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

Возвращает «действующие политики» для указанного пользователя или пользователей. Это просто означает, что если пользователю назначена политика уровня пользователя, то будет отображаться удостоверение этой политики. Если пользователю не назначена политика уровня пользователя, то командлет Get-CsEffectivePolicy указывает, какой политикой управляется пользователь: политикой службы, политикой сайта или глобальной политикой. Так вы можете точно определить, какая политика используется для управления этим пользователем. Данный командлет впервые появился в Lync Server 2013.

Get-CsEffectivePolicy -Identity <UserIdParameter> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ResultSize <Unlimited>]

В примере 1 команда возвращает действующие политики для пользователя Active Directory с отображаемым именем Ken Myer.

Get-CsEffectivePolicy - Identity "Ken Myer"

В указанной выше команде возвращается информация о действующей политике для пользователей с отображаемыми именами Ken Myer и Pilar Ackerman. Чтобы получить информацию о политике для нескольких пользователей, нужно передать несколько удостоверений пользователей в командлет Get-CsEffectivePolicy .

"Ken Myer","Pilar Ackerman" | Get-CsEffectivePolicy

В примере 3 возвращается информация о действующей политике для всех пользователей, которым была назначена политика конференц-связи RedmondConferencingPolicy. Для этого команда сначала с помощью командлета Get-CsUser получает коллекцию пользователей, которым была назначена политика RedmondConferencingPolicy; с помощью параметра Filter и значения фильтра {ConferencingPolicy –eq "RedmondConferencingPolicy"} в возвращаемые данные включаются только пользователи, которым была назначена политика конференц-связи RedmondConferencingPolicy на уровне пользователя. Затем эта коллекция учетных записей пользователей передается командлету Get-CsEffectivePolicy , который отображает информацию о действующей политике для каждого пользователя в коллекции.

Get-CsUser -Filter {ConferencingPolicy -eq "RedmondConferencingPolicy"} | Get-CsEffectivePolicy

Пример 4 является вариантом команды из примера 3. В данном примере снова возвращается информация о действующей политике для всех пользователей, которым была назначена политика конференц-связи RedmondConferencingPolicy, однако в этом случае возвращаемая информация содержит только удостоверение пользователя и политику мобильной связи. Для этого возвращается вся информация о действующей политике, а затем данные передаются командлету Select-Object , который, в свою очередь, включает в отображаемые данные только свойства Identity и MobilityPolicy.

Get-CsUser -Filter {ConferencingPolicy -eq "RedmondConferencingPolicy"} | Get-CsEffectivePolicy | Select-Object Identity, MobilityPolicy

В примере 5 отображается информация о действующей политике для всех пользователей финансового отдела. Для выполнения этой задачи сначала используются командлет Get-CsUser и свойство LdapFilter, чтобы получить коллекцию учетных записей пользователей; с помощью значения фильтра "Department=Finance" в число этих учетных записей включаются только пользователи, работающие в финансовом отделе. Затем эта коллекция передается командлету Get-CsEffectivePolicy , который отображает информацию о действующей политике для каждого пользователя в коллекции.

Get-CsUser -LdapFilter "Department=Finance" | Get-CsEffectivePolicy

Среди прочего командлет Get-CsUser возвращает сведения о политиках Microsoft Lync Server, используемых для управления поведением пользователя. Например:

DialPlan : RedmondDialPlan

LocationPolicy : RedmondLocationPolicy

ClientPolicy :

В приведенных выше выходных данных может показаться, что пользователь управляется некоторой абонентской группой и политикой местонахождения, но не управляется клиентом. На самом деле пользователь управляется клиентской политикой — глобальной политикой или политикой сайта. Однако командлет Get-CsUser возвращает только сведения о назначенных данному пользователю политиках на уровне пользователей и не возвращает никаких сведений о том, управляется ли пользователь глобальной политикой, политикой сайта или политикой службы.

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

LocationProfile : RedmondDialPlan

LocationPolicy : RedmondLocationPolicy

ClientPolicy : Global

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

Обратите внимание на то, что в отличие от Get-CsUser командлет Get-CsEffectivePolicy возвращает только сведения о политиках — он не возвращает дополнительные сведения, например, номер телефона пользователя или пул Регистратора. Помните и о том, что существуют различия в терминологии, используемой Get-CsEffectivePolicy для пометки имен политик, и терминологией, используемой Get-CsEffectivePolicy. Например, Get-CsUser использует имя DialPlan, а Get-CsEffectivePolicy — имя LocationProfile.

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

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

Панель Панель управления Skype для бизнеса Server: функции, выполняемые командлетом Get-CsEffectivePolicy , недоступны напрямую в панели Панель управления Skype для бизнеса Server.

 

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

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

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

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

Credential

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

System.Management.Automation.PSCredential

Позволяет выполнить командлет Get-CsEffectivePolicy с использованием альтернативных учетных данных. Это может потребоваться в случае, если учетная запись, используемая для входа в Windows, не обладает необходимыми привилегиями для работы с объектами пользователей.

Чтобы использовать параметр Credential, необходимо сначала создать объект PSCredential с помощью командлета Get-Credential . Дополнительные сведения см. в разделе справки, посвященном командлету Get-Credential .

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

Позволяет подключиться к определенному контроллеру домена для получения сведений о пользователе. Чтобы подключиться к определенному контроллеру домена, следует добавить параметр DomainController, за которым следует полное доменное имя (FQDN). Например:

-DomainController "atl-dc-001.litwareinc.com"

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Позволяет ограничить количество записей, возвращаемых командлетом. Например, чтобы в результатах были данные о 7 пользователях (независимо от количества пользователей в лесу), добавьте параметр ResultSize со значением 7. Следует отметить, что будут возвращены данные о случайных семи пользователях.

В качестве размера результата можно задать любое целое число от 0 до 2147483647 включительно. Если задано значение 0, команда выполняется, но данные не возвращаются. Если для ResultSize задано значение 7, но в лесу имеется только три пользователя, команда возвращает этих трех пользователей и затем завершается без ошибки.

Строка или объект Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Get-CsEffectivePolicy принимает конвейерное строковое значение, представляющее отображаемое имя учетной записи пользователя, разрешенной для Skype для бизнеса Server 2015. Командлет принимает также конвейерные экземпляры объекта пользователя Active Directory.

Командлет Get-CsEffectivePolicy возвращает экземпляры объекта Microsoft.Rtc.Management.AD.Cmdlets.EffectivePolicies.

 
Показ: