Set-CMCloudManagementGateway

(CMG) 配置云管理网关。

语法

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

说明

使用此 cmdlet (CMG) 配置云管理网关。

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

注意

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

示例

示例 1:更改 CMG 警报配置

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

示例 2:更改 CMG 服务的虚拟机数

此示例面向名为 GraniteFalls 的 CMG,并将 VM 数更改为 4

Set-CMCloudManagementGateway -Name "GraniteFalls" -VMInstancesCount 4

示例 3:允许 CMG 提供 Azure 存储中的内容

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

示例 4:添加两个新的证书颁发机构

$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

示例 5:更新 CMG 服务器身份验证证书

此示例面向名为 GraniteFalls 的 CMG 并更新 CMG 服务器身份验证证书。

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

示例 6:从 CMG 中删除根证书

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

参数

-CARootCert

将根证书添加到云服务。

类型:Hashtable
别名:CARootCertificate, CARootCertificates
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CheckClientCertRevocation

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Description

指定此 CMG 服务的可选说明以更好地识别它。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableCloudDPFunction

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableStorageQuota

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableTrafficOut

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnforceProtocol

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

运行命令而不要求确认。 如果服务证书包含多个 DNS 名称,请使用此参数来避免来自 cmdlet 的警告。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Id

指定 Azure 服务的站点 ID。 ID 是存储在服务的站点数据库中的整数值。 例如,运行以下 SQL 查询,并查看 ID 列: select * from Azure_CloudService

类型:String
别名:AzureServiceId
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-InputObject

指定要配置的 CMG 对象。 若要获取此对象,请使用 Get-CMCloudManagementGateway cmdlet。

类型:IResultObject
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定要配置的 CMG 的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-PassThru

返回一个 对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RemoveCertThumbprints

适用于版本 2010 及更高版本。 指定一个或多个证书指纹,以将其作为根证书颁发机构或中间证书颁发机构从 CMG 中删除。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ServiceCertPassword

适用于版本 2006 及更高版本。 在 -ServiceCertPath 中指定证书的密码。

类型:SecureString
别名:ServiceCertificatePassword
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ServiceCertPath

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

类型:String
别名:ServiceCertificatePath
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-StorageCriticalPct

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

类型:Int32
别名:StorageCriticalPercent
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-StorageQuotaGB

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-StorageWarningPct

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

类型:Int32
别名:StorageWarningPercent
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TrafficCriticalPct

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TrafficOutGB

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TrafficOutStopService

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

类型:Boolean
别名:StopTrafficOutService
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TrafficWarningPct

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMInstanceCount

适用于版本 2010 及更高版本。 指定虚拟机的实例计数。

类型:Int32
别名:VMInstancesCount
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object