New-CMCloudManagementGateway

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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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.

Type:Hashtable
Aliases:CARootCertification, CARootCertifications
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Confirm

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

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

-Description

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

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

-DisableWildcardHandling

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

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

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

-EnableStorageQuota

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

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

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

-EnforceProtocol

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

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

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

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

-ForceWildcardHandling

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

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

-GroupName

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

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

-IsUsingExistingGroup

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

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

-Region

Geben Sie die Azure-Dienstregion an, z. B. . 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

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 Microsoft Entra App-Name.

Type:String
Aliases:ServerApplicationClientId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServiceCertPassword

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

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

-ServiceCertPath

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

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

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

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

-StorageQuotaGB

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

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

-StorageWarningPct

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

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

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

-TenantId

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

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

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

-TrafficOutGB

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

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

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

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

-VMInstanceCount

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

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

-WhatIf

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

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

Eingaben

None

Ausgaben

IResultObject