New-CMCloudManagementAzureService

Créez le service Azure pour la gestion cloud dans Configuration Manager.

Syntaxe

New-CMCloudManagementAzureService
   [-AddGroupName <String[]>]
   [-AzureEnvironmentOption <AzureEnvironment>]
   -ClientApp <IResultObject>
   [-Description <String>]
   [-EnableGroupDeltaDiscovery <Boolean>]
   [-EnableGroupDiscovery <Boolean>]
   [-EnableUserDeltaDiscovery <Boolean>]
   [-EnableUserDiscovery <Boolean>]
   [-GroupDeltaDiscoveryMins <Int32>]
   [-GroupDiscoverySchedule <IResultObject>]
   -Name <String>
   -ServerApp <IResultObject>
   [-UserDeltaDiscoveryMins <Int32>]
   [-UserDiscoverySchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer le service Azure dans Configuration Manager pour la gestion cloud.

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 le service de gestion cloud , consultez Vue d’ensemble de la passerelle de gestion cloud.

Exemples

Exemple 1

Cet exemple obtient d’abord les applications serveur et clientes précédemment importées à l’aide de l’applet de commande Get-CMAADApplication . Il crée ensuite le service dans le site pour le cloud Azure global.

$serverApp = Get-CMAADApplication -TenantName "Contoso" -AppType ServerApplication -AppName "CmgServerApp"

$clientApp = Get-CMAADApplication -TenantName "Contoso" -AppType ClientApplication -AppName "CmgClientApp"

New-CMCloudManagementAzureService -Name "Contoso" -Description "Azure Service" -ServerApp $serverApp -ClientApp $clientApp -AzureEnvironmentOption AzurePublicCloud

Paramètres

-AddGroupName

Spécifiez un nom de groupe Microsoft Entra à découvrir. Utilisez ce paramètre avec le paramètre EnableGroupDiscovery .

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

-AzureEnvironmentOption

Spécifiez si ce service 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

-ClientApp

Spécifiez un objet pour l’inscription de l’application cliente. Pour obtenir cette application, utilisez l’applet de commande Get-CMAADApplication .

Type:IResultObject
Alias:ClientApplication, NativeClientApplication
Position:Named
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

-Description

Spécifiez une description facultative pour le service.

Type:String
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

-EnableGroupDeltaDiscovery

Définissez ce paramètre sur true pour activer la découverte delta pour la découverte de groupe Microsoft Entra. Utilisez ce paramètre avec le paramètre EnableGroupDiscovery . Utilisez le paramètre GroupDeltaDiscoveryMins pour configurer l’intervalle de découverte delta.

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

-EnableGroupDiscovery

Définissez ce paramètre sur true pour activer la découverte de groupe Microsoft Entra. Lorsque vous activez cette méthode de découverte, configurez également les paramètres suivants :

  • AddGroupName : ajouter des groupes Microsoft Entra à découvrir
  • EnableGroupDeltaDiscovery : Configurer la découverte delta
  • GroupDeltaDiscoveryMins : intervalle de découverte delta
  • GroupDiscoverySchedule : planification complète de l’interrogation

Pour plus d’informations sur cette méthode de découverte, consultez Découverte de groupes d’utilisateurs Microsoft Entra.

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

-EnableUserDeltaDiscovery

Définissez ce paramètre sur true pour activer la découverte delta pour la découverte d’utilisateurs Microsoft Entra. Utilisez ce paramètre avec le paramètre EnableUserDiscovery .

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

-EnableUserDiscovery

Définissez ce paramètre sur true pour activer la découverte d’utilisateurs Microsoft Entra. Lorsque vous activez cette méthode de découverte, configurez également les paramètres suivants :

  • EnableUserDeltaDiscovery : Configurer la découverte delta
  • UserDeltaDiscoveryMins : intervalle de découverte delta
  • UserDiscoverySchedule : planification complète de l’interrogation

Pour plus d’informations sur cette méthode de découverte, consultez Découverte d’utilisateurs Microsoft Entra.

Type:Boolean
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

-GroupDeltaDiscoveryMins

Lorsque vous activez la découverte delta pour la découverte de groupe Microsoft Entra avec le paramètre EnableGroupDeltaDiscovery , utilisez ce paramètre pour configurer l’intervalle de découverte delta. La valeur entière que vous spécifiez est l’intervalle d’interrogation en minutes.

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

-GroupDiscoverySchedule

Spécifiez un objet de planification pour la planification complète de l’interrogation de la découverte de groupe Microsoft Entra. Pour obtenir cet objet, utilisez l’applet de commande New-CMSchedule .

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

-Name

Spécifiez un nom pour distinguer le service de gestion cloud dans Configuration Manager.

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

-ServerApp

Spécifiez un objet pour l’inscription de l’application serveur. Pour obtenir cette application, utilisez l’applet de commande Get-CMAADApplication .

Type:IResultObject
Alias:WebApp, WebApplication, ServerApplication
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserDeltaDiscoveryMins

Lorsque vous activez la découverte delta pour la découverte d’utilisateurs Microsoft Entra avec le paramètre EnableUserDeltaDiscovery , utilisez ce paramètre pour configurer l’intervalle de découverte delta. La valeur entière que vous spécifiez est l’intervalle d’interrogation en minutes.

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

-UserDiscoverySchedule

Spécifiez un objet de planification pour la planification complète de l’interrogation de découverte d’utilisateurs Microsoft Entra. Pour obtenir cet objet, utilisez l’applet de commande New-CMSchedule .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:False
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

Notes

Vous ne pouvez pas activer la synchronisation de groupe Microsoft Entra lorsque vous créez le service. Pour activer la synchronisation de groupe, utilisez l’applet de commande Set-CMCloudManagementAzureService avec le paramètre EnableAADGroupSync .