Set-CMCloudManagementGateway

Référence

Module:: ConfigurationManager

Configurez une passerelle de gestion cloud (CMG).

Syntaxe

Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -InputObject <IResultObject>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -Id <String>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -Name <String>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour configurer une passerelle de gestion cloud (CMG).

Pour plus d’informations, consultez Vue d’ensemble de la passerelle de gestion cloud.

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 : Modifier la configuration des alertes de passerelle de gestion cloud

Set-CMCloudManagementGateway -Name "GraniteFalls" -EnableTrafficOut $true -TrafficOutGB 10000 -TrafficWarningPct 50 -TrafficCriticalPct 90 -EnableStorageQuota $true -StorageQuotaGB 2000 -StorageWarningPct 50 -StorageCriticalPct 90

Exemple 2 : Modifier le nombre de machines virtuelles pour le service de passerelle de gestion cloud

Cet exemple cible la passerelle de gestion cloud nommée GraniteFalls et remplace le nombre de machines virtuelles par 4.

Set-CMCloudManagementGateway -Name "GraniteFalls" -VMInstancesCount 4

Exemple 3 : Activer la passerelle de gestion cloud pour traiter le contenu à partir du stockage Azure

Set-CMCloudManagementGateway -Name "GraniteFalls" -EnableCloudDPFunction $true

Exemple 4 : Ajouter deux nouvelles autorités de certification

$path1 = "folder\root.cer"
$type1 = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::RootCA

$path2 = "folder\intermediate.cer"
$type2 = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::IntermediateCA

$cert = @{$path1 = $type1; $path2 = $type2}

Set-CMCloudManagementGateway -Name "GraniteFalls" -CARootCert $cert

Exemple 5 : Mettre à jour le certificat d’authentification du serveur de passerelle de gestion cloud

Cet exemple cible la passerelle de gestion cloud nommée GraniteFalls et met à jour le certificat d’authentification du serveur de passerelle de gestion cloud.

Set-CMCloudManagementGateway -Name "GraniteFalls" -ServiceCertPath "c:\TestPath\NewServiceCert.pfx" -ServiceCertPassword (ConvertTo-SecureString -String "tX*xJ11Nuo^B" -AsPlainText -Force)

Exemple 6 : Supprimer un certificat racine d’une passerelle de gestion cloud

Set-CMCloudManagementGateway -Name "GraniteFalls" -RemoveCertThumbprints "A7CBA0014DEF847593569D05003D5B96A1D6A627"

Paramètres

-CARootCert

Ajoutez des certificats racines au service cloud.

Type:	Hashtable
Alias:	CARootCertificate, CARootCertificates
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
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

Spécifiez une description facultative de ce service de passerelle de gestion cloud pour mieux l’identifier.

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

-Force

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

-Id

Spécifiez l’ID du site pour le service Azure. L’ID est la valeur entière stockée dans la base de données du site pour le service. Par exemple, exécutez la requête SQL suivante et examinez la colonne ID : select * from Azure_CloudService.

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

-InputObject

Spécifiez un objet de passerelle de gestion cloud à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMCloudManagementGateway .

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

-Name

Spécifiez le nom de la passerelle de gestion cloud à configurer.

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

-PassThru

Renvoie un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

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

-RemoveCertThumbprints

S’applique à la version 2010 et ultérieure. Spécifiez une ou plusieurs empreintes de certificat pour les supprimer en tant qu’autorités de certification racines ou intermédiaires de la passerelle de gestion cloud.

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

-ServiceCertPassword

S’applique à la version 2006 et ultérieure. Spécifiez le mot de passe du certificat dans -ServiceCertPath.

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

-ServiceCertPath

S’applique à la version 2006 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:	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

-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
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
Alias:	StopTrafficOutService
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
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

S’applique à la version 2010 et ultérieure. Spécifiez le nombre d’instances de machines virtuelles.

Type:	Int32
Alias:	VMInstancesCount
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 ne s’exécute pas.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Partager via