Import-CMAADServerApplication

  • Ссылка
Модуль:
ConfigurationManager

Создайте определение приложения сервера Microsoft Entra в Configuration Manager.

Синтаксис

Import-CMAADServerApplication
      [-AppIdUri <Uri>]
      [-AppName] <String>
      [-AzureEnvironmentOption <AzureEnvironment>]
      [-ClientId] <String>
      [-SecretKey] <SecureString>
      [-SecretKeyExpiry] <DateTime>
      [-TenantId] <String>
      [-TenantName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Используйте этот командлет для импорта серверного приложения из Идентификатора Microsoft Entra и определения его для сайта Configuration Manager. Предполагается, что администратор Azure уже создал приложение с идентификатором Microsoft Entra. В идентификаторе Microsoft Entra это приложение называется регистрацией веб-приложения .

Дополнительные сведения об использовании этого командлета для создания шлюза управления облаком (CMG) см. в заметках о выпуске 2010 г. Шлюз управления облаком.

Дополнительные сведения о приложениях Microsoft Entra в Configuration Manager см. в разделе Настройка служб Azure.

Примечание.

Этот командлет может работать с другими службами Azure, но он протестирован только с подключением к управлению облаком для поддержки шлюза управления облаком (CMG).

Примеры

Пример 1

В этом примере первая команда создает переменную datetime для 11/16/2021. Вторая команда использует эту переменную date в качестве даты окончания срока действия секретного ключа при импорте серверного приложения с использованием указанных сведений.

$date = [datetime]::parseexact("11/16/2021", 'MM/dd/yyyy', $null)

Import-CMAADServerApplication -TenantName "Contoso" -TenantId "05a349fa-298a-4427-8771-9efcdb73431e" -AppName "CmgServerApp" -ClientId "7078946d-fc1c-43b7-8dee-dd6e6b00d783" -SecretKey "1uXGR^!0@Cjas6qI*J02ZeS&&zY19^hC*9" -SecretKeyExpiry $date

Параметры

-AppIdUri

Укажите URI идентификатора приложения записи регистрации приложения в Центре администрирования Microsoft Entra. Это значение должно быть уникальным в клиенте Microsoft Entra. Он находится в маркере доступа, используемом клиентом Configuration Manager для запроса доступа к службе. Формат аналогичен https://ConfigMgrService.

Тип:Uri
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AppName

Укажите понятное имя приложения. Это значение является отображаемым именем в регистрации приложения.

Тип:String
Aliases:ApplicationName
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AzureEnvironmentOption

Укажите, находится ли эта регистрация приложения в глобальном облаке Azure (AzurePublicCloud) или в облаке Azure для государственных организаций (AzureUSGovernmentCloud).

Тип:AzureEnvironment
Допустимые значения:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ClientId

Укажите значение идентификатора приложения (клиента) для регистрации приложения в microsoft Entra ID. Формат является стандартным GUID.

Тип:String
Position:3
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SecretKey

Укажите секретный ключ для этого приложения, скопированный на портале Azure. Вы скопировали секретный ключ при регистрации приложения в Microsoft Entra ID.

Тип:SecureString
Position:4
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SecretKeyExpiry

Укажите дату истечения срока действия SecretKey . Это значение настраивается при создании секретного ключа для приложения в идентификаторе Microsoft Entra.

Тип:DateTime
Position:5
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TenantId

Укажите GUID клиента Microsoft Entra.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TenantName

Укажите имя клиента Microsoft Entra.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

IResultObject