Set-CMCloudManagementGateway

模块:

ConfigurationManager

使用 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 服务的虚拟机数量

此示例面向名为 "FallFalls" 的 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 服务器身份验证证书

此示例面向名为 "FallFalls" 的 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

将根证书添加到云服务。

Type:	Hashtable
Aliases:	CARootCertificate, CARootCertificates
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CheckClientCertRevocation

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

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-EnableCloudDPFunction

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

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

-EnableStorageQuota

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

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

-EnableTrafficOut

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

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

-EnforceProtocol

适用于版本 2010 及更高版本。 启用或禁用强制 TLS 1.2 的选项。

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

-Force

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

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

-ForceWildcardHandling

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

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

-Id

指定 Azure 服务的网站 ID。 Id是存储在服务的网站数据库中的整数值。 例如，运行以下SQL查询，然后查看ID列 select * from Azure_CloudService ：。

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

-InputObject

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

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

-PassThru

返回一个对象，该对象代表正在处理的项目。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-RemoveCertThumbprints

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

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

-ServiceCertPassword

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

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

-ServiceCertPath

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

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

-StorageCriticalPct

适用于版本 2010 及更高版本。 为"生成关键警报"指定整数**值 (存储警报阈值的百分比) 。 ** 例如，90。

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

-StorageQuotaGB

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

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

-StorageWarningPct

适用于版本 2010 及更高版本。 指定生成警告警告的整数**值 (存储警告阈值的百分比) 。 ** 例如，50。

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

-TrafficCriticalPct

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

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

-TrafficOutGB

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

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

-TrafficOutStopService

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

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

-TrafficWarningPct

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

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

-VMInstanceCount

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

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

-WhatIf

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

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

-名称

指定要配置的 CMG 的名称。

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

-描述

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Get-CMCloudManagementGateway
• New-CMCloudManagementGateway
• Remove-CMCloudManagementGateway
• Start-CMCloudManagementGateway
• Stop-CMCloudManagementGateway
• CMG 概述