Partager via

Import-CMAADServerApplication

  • Référence
Module:
ConfigurationManager

Créez la définition d’application serveur Microsoft Entra dans Configuration Manager.

Syntaxe

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

Description

Utilisez cette applet de commande pour importer l’application serveur à partir de l’ID Microsoft Entra et la définir pour le site Configuration Manager. Il part du principe qu’un administrateur Azure a déjà créé l’application dans l’ID Microsoft Entra. Dans l’ID Microsoft Entra, cette application est appelée inscription d’application web .

Pour plus d’informations sur l’utilisation de cette applet de commande pour créer une passerelle de gestion cloud (CMG), consultez Notes de publication 2010 : Passerelle de gestion cloud.

Pour plus d’informations sur les applications Microsoft Entra dans Configuration Manager, consultez Configurer les services Azure.

Remarque

Cette applet de commande peut fonctionner avec d’autres services Azure, mais elle est testée uniquement avec la connexion de gestion cloud pour prendre en charge la passerelle de gestion cloud (CMG).

Exemples

Exemple 1

Dans cet exemple, la première commande crée une variable datetime pour 11/16/2021. La deuxième commande utilise cette variable de date comme date d’expiration de la clé secrète, lorsqu’elle importe l’application serveur à l’aide des détails fournis.

$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

Paramètres

-AppIdUri

Spécifiez l’URI d’ID d’application de l’entrée d’inscription de l’application dans le Centre d’administration Microsoft Entra. Cette valeur doit être unique dans votre locataire Microsoft Entra. Il se trouve dans le jeton d’accès utilisé par le client Configuration Manager pour demander l’accès au service. Le format est similaire à https://ConfigMgrService.

Type:Uri
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AppName

Spécifiez le nom convivial de l’application. Cette valeur est le nom d’affichage dans l’inscription de l’application.

Type:String
Alias:ApplicationName
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AzureEnvironmentOption

Spécifiez si cette inscription d’application se trouve dans le cloud Azure global (AzurePublicCloud) ou dans le cloud Azure Government (AzureUSGovernmentCloud).

Type:AzureEnvironment
Valeurs acceptées:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClientId

Spécifiez la valeur ID d’application (client) de l’inscription de l’application dans l’ID Microsoft Entra. Le format est un GUID standard.

Type:String
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SecretKey

Spécifiez la clé secrète pour cette application telle qu’elle a été copiée à partir du portail Azure. Vous avez copié la clé secrète lorsque vous avez inscrit l’application dans l’ID Microsoft Entra.

Type:SecureString
Position:4
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SecretKeyExpiry

Spécifiez la date d’expiration de SecretKey . Vous configurez cette valeur lorsque vous créez la clé secrète pour l’application dans l’ID Microsoft Entra.

Type:DateTime
Position:5
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TenantId

Spécifiez le GUID de votre locataire Microsoft Entra.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TenantName

Spécifiez le nom de votre locataire Microsoft Entra.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject