New-CMCloudManagementGateway

Créez une passerelle de gestion cloud.

Syntax

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 Configuration Manager applets de commande à 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
Aliases:CARootCertification, CARootCertifications
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:VerifyClientCertificateRevocation
Position:Named
Default value:None
Required:False
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

-Description

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

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

-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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnforceProtocol

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:AzureEnvironmentOption
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
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

-GroupName

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

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

-Region

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

Type:AzureRegion
Accepted values:EastUS, SouthCentralUS, WestEurope, SoutheastAsia, WestUS2, WestCentralUS
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:ServerApplicationClientId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServiceCertPassword

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

Type:SecureString
Aliases:ServiceCertificatePassword
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:ServiceCertificatePath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:StorageCriticalPercent
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:StorageWarningPercent
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

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

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

-VMInstanceCount

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

Type:Int32
Position:Named
Default value:None
Required:False
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