Share via

New-CMCloudManagementGateway

  • 参考
模块:
ConfigurationManager

创建云管理网关。

语法

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

说明

使用此 cmdlet (Azure 中的 CMG) 服务创建云管理网关。 有关如何使用此 cmdlet (CMG) 创建云管理网关的详细信息，请参阅 2010 发行说明：云管理网关。

有关详细信息，请参阅 CMG 概述。

从版本 2010 开始，从此 cmdlet 中删除了以下参数：

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

有关版本 2010 中对此 cmdlet 的其他更改的详细信息，请参阅 2010 发行说明。

注意

从Configuration Manager站点驱动器运行Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 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"

示例 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

参数

-CARootCert

适用于版本 2010 及更高版本。 将根证书添加到云服务。

Type:Hashtable
Aliases:CARootCertification, CARootCertifications
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckClientCertRevocation

将此参数设置为 以 true 验证客户端证书吊销。 必须公开发布证书吊销列表 (CRL) 才能使此验证正常工作。 有关详细信息，请参阅 发布证书吊销列表。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Description

CMG 的可选说明，用于在Configuration Manager控制台中更好地识别它。

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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-EnableCloudDPFunction

适用于版本 2010 及更高版本。 启用或禁用 “允许 CMG 充当云分发点并提供 Azure 存储中的内容”选项。

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

-EnableStorageQuota

适用于版本 2010 及更高版本。 启用或禁用 “指定存储警报阈值”选项。

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

-EnableTrafficOut

适用于版本 2010 及更高版本。 启用或禁用用于 监视出站数据传输的“启用 14 天阈值和警报”选项。

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

-EnforceProtocol

适用于版本 2010 及更高版本。 启用或禁用 “强制实施 TLS 1.2”选项。

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

-EnvironmentSetting

指定要部署 CMG 的 Azure 环境：全局 Azure 云 (AzurePublicCloud) 或Azure 政府云 (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

适用于版本 2010 及更高版本。 运行命令而不要求确认。 如果服务证书包含多个 DNS 名称，请使用此参数来避免来自 cmdlet 的警告。

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

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

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

-GroupName

适用于版本 2010 及更高版本。 指定 Azure 资源组的名称。

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

-IsUsingExistingGroup

适用于版本 2010 及更高版本。 指定 Azure 资源组是否已存在。

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

-Region

指定 Azure 服务区域，例如： 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

适用于版本 2010 及更高版本。 指定Microsoft Entra服务器应用的客户端 ID。 将此参数用于非用户交互模式。 在 CMG 属性中，此值是Microsoft Entra应用名称。

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

-ServiceCertPassword

适用于版本 2010 及更高版本。 指定服务证书的密码。

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

-ServiceCertPath

适用于版本 2010 及更高版本。 指定服务证书的路径。 有关详细信息，请参阅 CMG 服务器身份验证证书。

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

-ServiceName

适用于版本 2010 及更高版本。 指定 Azure 服务名称。 如果未指定此参数，Configuration Manager使用服务证书的第一个 DNS 名称。 如果证书有多个 DNS 名称，请使用此参数指定要使用的名称。

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

-StorageCriticalPct

适用于版本 2010 及更高版本。 为 “生成严重警报”指定一个整数值 (%的存储警报阈值) 。 例如，90。

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

-StorageQuotaGB

适用于版本 2010 及更高版本。 指定 存储警报阈值的整数值 (GB) 。 例如，2。

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

-StorageWarningPct

适用于版本 2010 及更高版本。 为 “生成警告警报”指定一个整数值 (%的存储警报阈值) 。 例如，50。

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

-SubscriptionId

指定要在其中部署此新云服务的 Azure 订阅的 ID。 此值的格式是标准 GUID。

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

-TenantId

必需参数，其中需要在创建 cmg 时添加 tenantId。

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

-TrafficCriticalPct

如果启用警报以监视出站数据传输，请指定引发 严重 警报的阈值百分比。 此值默认为 90 。

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

-TrafficOutGB

如果启用存储警报，请使用此参数指定存储警报阈值（以 GB 为单位）。 默认值为 2。

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

-TrafficOutStopService

适用于版本 2010 及更高版本。 启用或禁用在 超过关键阈值时停止此服务的选项。

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

-TrafficWarningPct

如果启用警报以监视出站数据传输，请指定引发 警告 警报的阈值百分比。 此值默认为 50 。

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

-VMInstanceCount

指定 Azure 中 CMG 的虚拟机的实例计数。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 该 cmdlet 未运行。

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

输入

None

输出

IResultObject