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