Set-CMCloudManagementGateway

  • Référence
Module:
ConfigurationManager

Configurer une passerelle de gestion cloud (CMG).

Syntax

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 cmdlet pour configurer une passerelle de gestion cloud (CMG).

Pour plus d’informations, voir vue d’ensemble de CMG.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1 : Modifier la configuration des alertes CMG

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 CMG

Cet exemple cible la CMG nomméeFalls et modifie le nombre de VM par 4 .

Set-CMCloudManagementGateway -Name "GraniteFalls" -VMInstancesCount 4

Exemple 3 : activer CMG pour servir 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 CMG

Cet exemple cible la CMG nommée ContrôleFalls et met à jour le certificat d’authentification du serveur CMG.

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’un CMG

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

Paramètres

- Confirmer

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CARootCert

Ajoutez des certificats racine au service cloud.

Type:Hashtable
Aliases:CARootCertificate, CARootCertificates
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CheckClientCertRevocation

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

Spécifiez une description facultative de ce service CMG pour mieux l’identifier.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableCloudDPFunction

S’applique aux versions 2010 et ultérieures. Activez ou désactivez l’option permettant à CMG de fonctionner en tant que point de distribution cloud et de servir le contenu à partir du stockage Azure.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableStorageQuota

S’applique aux versions 2010 et ultérieures. Activez ou désactivez l’option pour spécifier le seuil d’alerte de stockage.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableTrafficOut

S’applique aux versions 2010 et ultérieures. Activez ou désactivez l’option d’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
Accept pipeline input:False
Accept wildcard characters:False

-EnforceProtocol

S’applique aux versions 2010 et ultérieures. Activez ou désactivez l’option d’application de TLS 1.2.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Exécutez la commande sans demander confirmation. Si le certificat de service contient plusieurs noms DNS, utilisez ce paramètre pour éviter les avertissements de la cmdlet.

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

-Id

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

Type:String
Aliases:AzureServiceId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifiez un objet CMG à configurer. Pour obtenir cet objet, utilisez l’cmdlet Get-CMCloudManagementGateway.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifiez le nom du CMG à configurer.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveCertThumbprints

S’applique aux versions 2010 et ultérieures. Spécifiez une ou plusieurs empreintes de certificat pour les supprimer des autorités de certification racines ou intermédiaires de CMG.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ServiceCertPassword

S’applique aux versions 2006 et ultérieures. Spécifiez le mot de passe du certificat dans -ServiceCertPath.

Type:SecureString
Aliases:ServiceCertificatePassword
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ServiceCertPath

S’applique aux versions 2006 et ultérieures. Spécifiez le chemin d’accès au certificat de service. Pour plus d’informations, voir certificat d’authentification de serveur CMG.

Type:String
Aliases:ServiceCertificatePath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StorageCriticalPct

S’applique aux versions 2010 et ultérieures. Spécifiez une valeur de nombre pour l’alerte Générer une alerte critique (% du seuil d’alerte de stockage). Par exemple, 90.

Type:Int32
Aliases:StorageCriticalPercent
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StorageQuotaGB

S’applique aux versions 2010 et ultérieures. Spécifiez une valeur d’un nombre Stockage seuil d’alerte (Go). Par exemple, 2.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StorageWarningPct

S’applique aux versions 2010 et ultérieures. Spécifiez une valeur de nombre pour l’alerte générer un avertissement (% du seuil d’alerte de stockage). Par exemple, 50.

Type:Int32
Aliases:StorageWarningPercent
Position:Named
Default value:None
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 niveau de levée d’une alerte critique. Cette valeur est 90 par défaut.

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

-TrafficOutStopService

S’applique aux versions 2010 et ultérieures. Activez ou désactivez l’option d’arrêt de ce service lorsque le seuil critique est dépassé.

Type:Boolean
Aliases:StopTrafficOutService
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TrafficWarningPct

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-VMInstanceCount

S’applique aux versions 2010 et ultérieures. Spécifiez le nombre d’instances de machines virtuelles.

Type:Int32
Aliases:VMInstancesCount
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object