Freigeben über


Set-CMCloudManagementGateway

Konfigurieren sie ein Cloudverwaltungsgateway (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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Cloudverwaltungsgateway (CLOUD Management Gateway, CMG) zu konfigurieren.

Weitere Informationen finden Sie unter ÜBERSICHT ÜBER CMG.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Ändern der CMG-Warnungskonfiguration

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

Beispiel 2: Ändern der Anzahl virtueller Computer für den CMG-Dienst

In diesem Beispiel wird das CMG namens GraniteFalls als Ziel verwendet, und die Anzahl der VMs wird in 4geändert.

Set-CMCloudManagementGateway -Name "GraniteFalls" -VMInstancesCount 4

Beispiel 3: Aktivieren des CMG für die Bereitstellung von Inhalten aus Azure Storage

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

Beispiel 4: Hinzufügen von zwei neuen Zertifizierungsstellen

$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

Beispiel 5: Aktualisieren des CMG-Serverauthentifizierungszertifikats

In diesem Beispiel wird das CMG namens GraniteFalls als Ziel verwendet und das CMG-Serverauthentifizierungszertifikat aktualisiert.

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

Beispiel 6: Entfernen eines Stammzertifikats aus einem CMG

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

Parameter

-CARootCert

Fügen Sie dem Clouddienst Stammzertifikate hinzu.

Typ:Hashtable
Aliase:CARootCertificate, CARootCertificates
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CheckClientCertRevocation

Legen Sie diesen Parameter auf fest true , um die Clientzertifikatsperrung zu überprüfen. Eine Zertifikatsperrliste (Certificate Revocation List, CRL) muss öffentlich veröffentlicht werden, damit diese Überprüfung funktioniert. Weitere Informationen finden Sie unter Veröffentlichen der Zertifikatsperrliste.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Geben Sie eine optionale Beschreibung dieses CMG-Diensts an, um ihn besser zu identifizieren.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableCloudDPFunction

Gilt für Version 2010 und höher. Aktivieren oder deaktivieren Sie die Option Zulassen, dass CMG als Cloudverteilungspunkt funktioniert und Inhalte aus Azure Storage bereitstellen kann.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableStorageQuota

Gilt für Version 2010 und höher. Aktivieren oder deaktivieren Sie die Option Speicherwarnungsschwellenwert angeben.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableTrafficOut

Gilt für Version 2010 und höher. Aktivieren oder deaktivieren Sie die Option 14-Tage-Schwellenwert und Warnungen für die Überwachung der ausgehenden Datenübertragung aktivieren oder deaktivieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnforceProtocol

Gilt für Version 2010 und höher. Aktivieren oder deaktivieren Sie die Option TLS 1.2 erzwingen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Führen Sie den Befehl aus, ohne zur Bestätigung zu fragen. Wenn das Dienstzertifikat mehrere DNS-Namen enthält, verwenden Sie diesen Parameter, um Warnungen des Cmdlets zu vermeiden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Geben Sie die ID des Standorts für den Azure-Dienst an. Die ID ist der ganzzahlige Wert, der in der Standortdatenbank für den Dienst gespeichert ist. Führen Sie beispielsweise die folgende SQL-Abfrage aus, und sehen Sie sich die ID-Spalte an: select * from Azure_CloudService.

Typ:String
Aliase:AzureServiceId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein zu konfigurierenes CMG-Objekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMCloudManagementGateway .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen des zu konfigurierenden CMG an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveCertThumbprints

Gilt für Version 2010 und höher. Geben Sie mindestens einen Zertifikatfingerabdruck an, um sie als Stammzertifizierungsstellen oder Zwischenzertifizierungsstellen aus dem CMG zu entfernen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceCertPassword

Gilt für Version 2006 und höher. Geben Sie das Kennwort für das Zertifikat in -ServiceCertPath an.

Typ:SecureString
Aliase:ServiceCertificatePassword
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceCertPath

Gilt für Version 2006 und höher. Geben Sie den Pfad zum Dienstzertifikat an. Weitere Informationen finden Sie unter CMG-Serverauthentifizierungszertifikat.

Typ:String
Aliase:ServiceCertificatePath
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageCriticalPct

Gilt für Version 2010 und höher. Geben Sie einen ganzzahligen Wert für die Warnung "Kritisch generieren" (% des Schwellenwerts für Speicherwarnungen) an. Beispiel: 90.

Typ:Int32
Aliase:StorageCriticalPercent
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageQuotaGB

Gilt für Version 2010 und höher. Geben Sie einen ganzzahligen Wert für den Speicherwarnungsschwellenwert (GB) an. Beispiel: 2.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageWarningPct

Gilt für Version 2010 und höher. Geben Sie einen ganzzahligen Wert für warnung generieren (% des Speicherwarnungsschwellenwerts) an. Beispiel: 50.

Typ:Int32
Aliase:StorageWarningPercent
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TrafficCriticalPct

Wenn Sie Warnungen für die Überwachung der ausgehenden Datenübertragung aktivieren, geben Sie den Prozentsatz des Schwellenwerts für das Auslösen einer Kritischen Warnung an. Dieser Wert ist 90 standardmäßig.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TrafficOutGB

Wenn Sie Speicherwarnungen aktivieren, verwenden Sie diesen Parameter, um den Speicherwarnungsschwellenwert in GB anzugeben. Der Standardwert ist 2.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TrafficOutStopService

Gilt für Version 2010 und höher. Aktivieren oder deaktivieren Sie die Option Diesen Dienst beenden, wenn der kritische Schwellenwert überschritten wird.

Typ:Boolean
Aliase:StopTrafficOutService
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TrafficWarningPct

Wenn Sie Warnungen für die Überwachung der ausgehenden Datenübertragung aktivieren, geben Sie den Prozentsatz des Schwellenwerts für das Auslösen einer Warnung an . Dieser Wert ist 50 standardmäßig.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMInstanceCount

Gilt für Version 2010 und höher. Geben Sie die Anzahl der Instanzen virtueller Computer an.

Typ:Int32
Aliase:VMInstancesCount
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object