Import-CMAADServerApplication

  • Référence
Module:
ConfigurationManager

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

Syntax

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 Microsoft Entra ID et la définir pour le site Configuration Manager. Il part du principe qu’un administrateur Azure a déjà créé l’application dans Microsoft Entra ID. Dans Microsoft Entra ID, 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 d’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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:ApplicationName
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientId

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

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Microsoft Entra ID.

Type:SecureString
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 Microsoft Entra ID.

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

-TenantId

Spécifiez le GUID de votre locataire Microsoft Entra.

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

-TenantName

Spécifiez le nom de votre locataire Microsoft Entra.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Sorties

IResultObject