Get-CsTenant

Skype for Business Server 2015
 

Дата изменения раздела:2017-05-23

Возвращает информацию о клиентах Lync Online, настроенных для использования в организации. Клиенты представляют группы интернет-пользователей. Во многих случаях требуется только один клиент. Но если есть группы пользователей с разными потребностями в управлении, Lync Online поддерживает организации с несколькими клиентами.

Командлет Get-CsTenant можно использовать только с Skype для бизнеса Online.

Get-CsTenant [[-Identity] <OUIdParameter>] [-Filter <String>] [-ResultSize <Unlimited`1>] [-Verbose]

Команда, представленная в примере 1, возвращает информацию обо всех клиентах, настроенных для использования в организации.

Get-CsTenant

В примере 2 возвращается информация для одного клиента — клиента с идентификатором "bf19b7db-6960-41e5-a139-2aa373474354".

Get-CsTenant -Identity "bf19b7db-6960-41e5-a139-2aa373474354"

Предшествующая команда предоставляет альтернативный способ получения информации для одного клиента. В этом примере для этого используются параметр Filter и значение фильтра {DisplayName –eq "Fabrikam"}. Этот синтаксис предназначен для возврата информации только для клиентов с отображаемым именем Fabrikam.

Get-CsTenant -Filter {DisplayName -eq "Fabrikam"}

Показанная в примере 4 команда возвращает информацию для всех клиентов со значением свойства ServiceInstance, равным "LitwareincCommunicationsOnline/San Antonio". Для этого в команде используется параметр Filter со значением {ServiceInstance -eq "LitwareincCommunicationsOnline/San Antonio"}. Это значение фильтра ограничивает возвращаемые данные клиентами, у которых свойство ServiceInstance имеет значение (-eq) "LitwareincCommunicationsOnline/San Antonio".

Get-CsTenant -Filter {ServiceInstance -eq "LitwareincCommunicationsOnline/San Antonio"}

В примере 5 возвращается информация для всех клиентов с отображаемым именем страны или региона "Australia". Для этого используется параметр Filter со значением {CountryOrRegionDisplayName -eq "Australia"}.

Get-CsTenant -Filter {CountryOrRegionDisplayName -eq "Australia"}

В Lync Online клиенты представляют группы пользователей с учетными записями, размещенными в данной службе. Некоторым организациям требуется только один клиент для размещения учетных записей всех своих пользователей. Но в Lync Online управление часто выполняется на уровне клиентов, т. е. у всех пользователей в одном клиенте будут одинаковые политики голосовой связи, параметры конфигурации федерации и т. д. Если разными пользователями требуется управлять по-разному, можно рассмотреть возможность использования нескольких клиентов с разными коллекциями политик и настроек.

Независимо от числа имеющихся клиентов, информацию о них можно получить с помощью командлета Get-CsTenant .

 

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

Filter

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

System.String

Позволяет возвращать данные с помощью атрибутов Active Directory, не указывая полное различающееся имя Active Directory. Например, чтобы извлечь сведения о клиенте по его отображаемому имени, используется синтаксис, подобный следующему:

Get-CsTenant –Filter {DisplayName –eq "FabrikamTenant"}

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

Get-CsTenant –Filter {Domains –like "*fabrikam*"}

Для параметра Filter используется тот же синтаксис фильтрации Windows PowerShell, что и для командлета Where-Object.

Нельзя использовать оба параметра (Identity и Filter) в одной команде.

Identity

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

Microsoft.Rtc.Management.AD.OUIdParameter

Различающееся имя Active Directory данного клиента. Например:

-Identity "OU=bf19b7db-6960-41e5-a139-2aa373474354,OU=OCS Tenants,dc=litwareinc,dc=com"

Если не включить параметр Identity или Filter, тогда командлет Get-CsTenant возвращает информацию обо всех клиентах.

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited`1

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

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

Командлет Get-CsTenant принимает по конвейеру экземпляры объекта Microsoft.Rtc.Management.ADConnect.Schema.TenantObject, а также строковые значения, представляющие удостоверение клиента Lync Online (например, "OU=bf19b7db-6960-41e5-a139-2aa373474354,OU=OCS Tenants,dc=vdomain,dc=com").

Командлет Get-CsTenant возвращает экземпляры объекта Microsoft.Rtc.Management.ADConnect.Schema.TenantObject.

 
Показ: