Get-CASMailboxPlan
Этот командлет работает только в облачной службе.
Используйте командлет Get-CASMailboxPlan для просмотра планов почтовых ящиков служб клиентского доступа (CAS) в облачных организациях.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-CASMailboxPlan
[[-Identity] <MailboxPlanIdParameter>]
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IgnoreDefaultScope]
[-ResultSize <Unlimited>]
[-SortBy <String>]
[<CommonParameters>]
Описание
План почтовых ящиков CAS привязан к соответствующему плану почтового ящика с тем же именем (и отображаемым именем). Как и планы почтовых ящиков, планы почтовых ящиков CAS соответствуют типам лицензий и применяются к почтовому ящику при лицензировании пользователя. Доступность плана почтового ящика CAS определяется выбранными вами параметрами при регистрации в службе и возрастом вашей организации.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-CASMailboxPlan | Format-Table -Auto DisplayName,ActiveSyncEnabled,ImapEnabled,PopEnabled,OwaMailboxPolicy
В этом примере возвращается сводный список всех планов почтовых ящиков CAS в организации.
Пример 2
Get-CASMailboxPlan -Identity ExchangeOnlineEnterprise
В этом примере возвращаются подробные сведения о указанном плане почтового ящика CAS.
Параметры
-Credential
Параметр Credential указывает имя пользователя и пароль, используемые для выполнения этой команды. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения.
Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential)
. Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential
), а затем используйте имя переменной ($cred
) для этого параметра. Для получения дополнительной информации см. Get-Credential.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-DomainController
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Filter
Параметр Filter использует синтаксис OPATH для фильтрации результатов по указанным свойствам и значениям. Для критериев поиска используется следующий синтаксис: "Property -ComparisonOperator 'Value'"
.
- Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например,
$true
,$false
или$null
), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные. - Property — это свойство с поддержкой фильтрации.
- ComparisonOperator — это оператор сравнения OPATH (например
-eq
, для равных и-like
для сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators. - Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки (
'Value'
или'$Variable'
). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо'$User'
используйте'$($User -Replace "'","''")'
. Не заключайте целые числа или системные значения в кавычки (например, используйте500
,$true
,$false
, или$null
вместо них).
Можно связать несколько условий поиска вместе с помощью логических операторов -and
и -or
. Например, "Criteria1 -and Criteria2"
или "(Criteria1 -and Criteria2) -or Criteria3"
.
Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Параметр Identity указывает план почтового ящика CAS, который нужно просмотреть. Вы можете использовать любой уникальный идентификатор плана почтового ящика CAS. Например:
- имя;
- различающееся имя (DN);
- GUID
Отображаемое имя и имя плана почтового ящика cas совпадают с соответствующим планом почтового ящика (например, ExchangeOnlineEnterprise и ExchangeOnlineEnterprise-GUID
).
Type: | MailboxPlanIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IgnoreDefaultScope
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ResultSize
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SortBy
Параметр SortBy указывает свойство, по которому необходимо сортировать результаты. Вы можете выполнять сортировку не более, чем по одному свойству одновременно. Результаты будут отсортированы в порядке возрастания.
Если в представлении по умолчанию нет свойства, по которым выполняется сортировка, можно добавить команду с | Format-Table -Auto Property1,Property2,...PropertyX
помощью . , чтобы создать новое представление, содержащее все свойства, которые нужно просмотреть. В именах свойств поддерживаются подстановочные знаки (*).
Можно выполнять сортировку по следующим атрибутам:
- DisplayName
- Имя
Результаты будут отсортированы в порядке возрастания.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.