New-CMCloudManagementGateway

Modul:

ConfigurationManager

Erstellen Sie ein Cloudverwaltungsgateway.

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um einen CMG-Dienst (Cloud Management Gateway) in Azure zu erstellen. Weitere Informationen zur Verwendung dieses Cmdlets zum Erstellen eines Cloudverwaltungsgateways (CMG) finden Sie in den Versionshinweisen 2010: Cloudverwaltungsgateway.

Weitere Informationen finden Sie unter ÜBERSICHT ÜBER CMG.

Ab Version 2010 wurden die folgenden Parameter aus diesem Cmdlet entfernt:

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

Weitere Informationen zu den anderen Änderungen an diesem Cmdlet in Version 2010 finden Sie in den Versionshinweisen zu 2010.

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

$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"

Beispiel 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

Parameter

-CARootCert

Gilt für Version 2010 und höher. Fügen Sie dem Clouddienst Stammzertifikate hinzu.

Typ:	Hashtable
Aliase:	CARootCertification, CARootCertifications
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
Aliase:	VerifyClientCertificateRevocation
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

Eine optionale Beschreibung des CMG, um es in der Configuration Manager-Konsole besser identifizieren zu können.

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

-EnvironmentSetting

Geben Sie die Azure-Umgebung an, um das CMG bereitzustellen: in der globalen Azure-Cloud (AzurePublicCloud) oder in der Azure Government-Cloud (AzureUSGovernmentCloud).

Typ:	AzureEnvironment
Aliase:	AzureEnvironmentOption
Zulässige Werte:	AzurePublicCloud, AzureUSGovernmentCloud
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Gilt für Version 2010 und höher. 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

-GroupName

Gilt für Version 2010 und höher. Geben Sie den Namen der Azure-Ressourcengruppe an.

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

-IsUsingExistingGroup

Gilt für Version 2010 und höher. Geben Sie an, ob die Azure-Ressourcengruppe bereits vorhanden ist.

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

-Region

Geben Sie die Azure-Dienstregion an, z. B. . WestUS2

Typ:	AzureRegion
Zulässige Werte:	EastUS, SouthCentralUS, WestEurope, SoutheastAsia, WestUS2, WestCentralUS
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServerAppClientId

Gilt für Version 2010 und höher. Geben Sie die Client-ID der Microsoft Entra-Server-App an. Verwenden Sie diesen Parameter für den Nichtbenutzerinteraktionsmodus. In den CMG-Eigenschaften ist dieser Wert der Name der Microsoft Entra-App.

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

-ServiceCertPassword

Gilt für Version 2010 und höher. Geben Sie das Kennwort für das Dienstzertifikat an.

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

-ServiceCertPath

Gilt für Version 2010 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:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServiceName

Gilt für Version 2010 und höher. Geben Sie den Namen des Azure-Diensts an. Wenn Sie diesen Parameter nicht angeben, verwendet Configuration Manager den ersten DNS-Namen des Dienstzertifikats. Wenn das Zertifikat über mehrere DNS-Namen verfügt, verwenden Sie diesen Parameter, um anzugeben, welcher verwendet werden soll.

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

-SubscriptionId

Geben Sie die ID des Azure-Abonnements an, in dem Sie diesen neuen Clouddienst bereitstellen möchten. Das Format dieses Werts ist eine Standard-GUID.

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

-TenantId

Obligatorischer Parameter, bei dem tenantId beim Erstellen von cmg hinzugefügt werden muss.

Typ:	String
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
Aliase:	TrafficCriticalPercent
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
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
Aliase:	TrafficWarningPercent
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-VMInstanceCount

Geben Sie die Instanzanzahl der virtuellen Computer für das CMG in Azure an.

Typ:	Int32
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

None

Ausgaben

IResultObject

Ähnliche Themen

• Get-CMCloudManagementGateway
• Remove-CMCloudManagementGateway
• Set-CMCloudManagementGateway
• Start-CMCloudManagementGateway
• Stop-CMCloudManagementGateway
• Import-CMAADServerApplication
• Import-CMAADClientApplication
• New-CMCloudManagementAzureService
• New-CMCloudManagementGateway
• Add-CMCloudManagementGatewayConnectionPoint
• Set-CMCloudManagementAzureService
• ÜBERSICHT ÜBER CMG