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.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppName

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

Type:String
Aliases:ApplicationName
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AzureEnvironmentOption

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

Type:AzureEnvironment
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientId

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

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecretKey

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

Type:SecureString
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecretKeyExpiry

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

Type:DateTime
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

None

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

IResultObject