Partager via


New-CMCloudManagementGateway

Créez une passerelle de gestion cloud.

Syntaxe

New-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-EnvironmentSetting <AzureEnvironment>]
   [-Force]
   [-GroupName <String>]
   [-IsUsingExistingGroup <Boolean>]
   [-Region <AzureRegion>]
   -ServiceCertPassword <SecureString>
   -ServiceCertPath <String>
   [-ServiceName <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-SubscriptionId <String>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-EnvironmentSetting <AzureEnvironment>]
   [-Force]
   -GroupName <String>
   [-Region <AzureRegion>]
   -ServerAppClientId <String>
   -ServiceCertPassword <SecureString>
   -ServiceCertPath <String>
   [-ServiceName <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   -SubscriptionId <String>
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un service de passerelle de gestion cloud (CMG) dans Azure. 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, consultez Vue d’ensemble de la passerelle de gestion cloud.

À compter de la version 2010, les paramètres suivants ont été supprimés de cette applet de commande :

  • GovernmentSubscription
  • ManagementCertificatePassword
  • ManagementCertificatePath
  • PassThru
  • RootCertificatePath
  • ServiceCertificatePassword
  • ServiceCertificatePath
  • ServiceCName

Pour plus d’informations sur les autres modifications apportées à cette applet de commande dans la version 2010, consultez notes de publication 2010.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1

$Path = "c:\TestPath\RootCA.cer"
$Type = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::RootCA
$Cert =@{$Path = $Type}

$Password = '0HNy*c@63kAe' | ConvertTo-SecureString -AsPlainText -Force

New-CMCloudManagementGateway -ServiceCertPath "c:\TestPath\ServiceCert.pfx" -EnvironmentSetting AzurePublicCloud -SubscriptionId "e517b8cb-a969-4d1e-b2ea-ae1e6c052020" -ServiceCertPassword $Password -ServiceName "GraniteFalls.CloudApp.Net" -Description "EastUS CMG for Contoso" -Region EastUS -VMInstanceCount 2 -CARootCert $Cert -CheckClientCertRevocation $False -EnforceProtocol $True -IsUsingExistingGroup $true -GroupName "Resource group 1"

Exemple 2

New-CMCloudManagementGateway -ServiceCertPath "c:\TestPath\ServiceCert.pfx" -EnvironmentSetting AzurePublicCloud -SubscriptionId "e517b8cb-a969-4d1e-b2ea-ae1e6c052020" -ServiceCertPassword $Password -ServiceName "GraniteFalls.CloudApp.Net" -Description "EastUS CMG for Contoso" -Region EastUS -VMInstanceCount 2 -CARootCert $Cert -CheckClientCertRevocation $False -EnforceProtocol $True -GroupName "Resource group 1" -EnableCloudDPFunction $true -EnableTrafficOut $true -TrafficOutStopService $true -TrafficOutGB 10000 -TrafficWarningPct 50 -TrafficCriticalPct 90 -EnableStorageQuota $true -StorageQuotaGB 2000 -StorageWarningPct 50 -StorageCriticalPct 90 -Force

Paramètres

-CARootCert

S’applique à la version 2010 et ultérieure. Ajoutez des certificats racines au service cloud.

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

-CheckClientCertRevocation

Définissez ce paramètre sur true pour vérifier la révocation du certificat client. Une liste de révocation de certificats (CRL) doit être publiée publiquement pour que cette vérification fonctionne. Pour plus d’informations, consultez Publier la liste de révocation de certificats.

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

Description facultative de la passerelle de gestion cloud pour mieux l’identifier dans la console Configuration Manager.

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

-EnableCloudDPFunction

S’applique à la version 2010 et ultérieure. Activez ou désactivez l’option Autoriser la passerelle de gestion cloud à fonctionner en tant que point de distribution cloud et à fournir du contenu à partir du stockage Azure.

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

-EnableStorageQuota

S’applique à la version 2010 et ultérieure. Activez ou désactivez l’option Spécifier le seuil d’alerte de stockage.

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

-EnableTrafficOut

S’applique à la version 2010 et ultérieure. Activez ou désactivez l’option Activer le seuil de 14 jours et les alertes pour la surveillance du transfert de données sortantes.

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

-EnforceProtocol

S’applique à la version 2010 et ultérieure. Activez ou désactivez l’option Appliquer TLS 1.2.

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

-EnvironmentSetting

Spécifiez l’environnement Azure pour déployer la passerelle de gestion cloud : dans le cloud Azure global (AzurePublicCloud) ou le cloud Azure Government (AzureUSGovernmentCloud).

Type:AzureEnvironment
Alias:AzureEnvironmentOption
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

-Force

S’applique à la version 2010 et ultérieure. Exécutez la commande sans demander de confirmation. Si le certificat de service contient plusieurs noms DNS, utilisez ce paramètre pour éviter les avertissements de l’applet de commande.

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

-GroupName

S’applique à la version 2010 et ultérieure. Spécifiez le nom du groupe de ressources Azure.

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

-IsUsingExistingGroup

S’applique à la version 2010 et ultérieure. Spécifiez si le groupe de ressources Azure existe déjà.

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

-Region

Spécifiez la région de service Azure, par exemple : WestUS2.

Type:AzureRegion
Valeurs acceptées:EastUS, SouthCentralUS, WestEurope, SoutheastAsia, WestUS2, WestCentralUS
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerAppClientId

S’applique à la version 2010 et ultérieure. Spécifiez l’ID client de l’application serveur Microsoft Entra. Utilisez ce paramètre pour le mode d’interaction non utilisateur. Dans les propriétés de la passerelle de gestion cloud, cette valeur est le nom de l’application Microsoft Entra.

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

-ServiceCertPassword

S’applique à la version 2010 et ultérieure. Spécifiez le mot de passe du certificat de service.

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

-ServiceCertPath

S’applique à la version 2010 et ultérieure. Spécifiez le chemin d’accès au certificat de service. Pour plus d’informations, consultez Certificat d’authentification serveur de la passerelle de gestion cloud.

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

-ServiceName

S’applique à la version 2010 et ultérieure. Spécifiez le nom du service Azure. Si vous ne spécifiez pas ce paramètre, Configuration Manager utilise le premier nom DNS du certificat de service. Si le certificat a plusieurs noms DNS, utilisez ce paramètre pour spécifier celui à utiliser.

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

-StorageCriticalPct

S’applique à la version 2010 et ultérieure. Spécifiez une valeur entière pour Générer une alerte critique (% du seuil d’alerte de stockage). Par exemple : 90.

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

-StorageQuotaGB

S’applique à la version 2010 et ultérieure. Spécifiez une valeur entière pour le seuil d’alerte de stockage (Go). Par exemple : 2.

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

-StorageWarningPct

S’applique à la version 2010 et ultérieure. Spécifiez une valeur entière pour générer l’alerte d’avertissement (% du seuil d’alerte de stockage). Par exemple : 50.

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

-SubscriptionId

Spécifiez l’ID de l’abonnement Azure dans lequel vous souhaitez déployer ce nouveau service cloud. Le format de cette valeur est un GUID standard.

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

-TenantId

Paramètre obligatoire où tenantId doit être ajouté lors de la création de cmg.

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

-TrafficCriticalPct

Si vous activez des alertes pour surveiller le transfert de données sortantes, spécifiez le pourcentage de seuil pour le déclenchement d’une alerte critique . Cette valeur est 90 par défaut.

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

-TrafficOutGB

Si vous activez les alertes de stockage, utilisez ce paramètre pour spécifier le seuil d’alerte de stockage en Go. La valeur par défaut est 2.

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

-TrafficOutStopService

S’applique à la version 2010 et ultérieure. Activez ou désactivez l’option Arrêter ce service lorsque le seuil critique est dépassé.

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

-TrafficWarningPct

Si vous activez des alertes pour la surveillance du transfert de données sortantes, spécifiez le pourcentage de seuil pour déclencher une alerte d’avertissement . Cette valeur est 50 par défaut.

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

-VMInstanceCount

Spécifiez le nombre d’instances de machines virtuelles pour la passerelle de gestion cloud dans Azure.

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

-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