Set-CMBoundaryGroup
修改边界组的属性。
语法
Set-CMBoundaryGroup
[-AddSiteSystemServer <IResultObject[]>]
[-AddSiteSystemServerName <String[]>]
[-AllowPeerDownload <Boolean>]
[-ClearSiteSystemServer]
[-DefaultSiteCode <String>]
[-Description <String>]
-InputObject <IResultObject>
[-NewName <String>]
[-PassThru]
[-PreferCloudDPOverDP <Boolean>]
[-PreferDPOverPeer <Boolean>]
[-RemoveSiteSystemServer <IResultObject[]>]
[-RemoveSiteSystemServerName <String[]>]
[-SubnetPeerDownloadOnly <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMBoundaryGroup
[-AddSiteSystemServer <IResultObject[]>]
[-AddSiteSystemServerName <String[]>]
[-AllowPeerDownload <Boolean>]
[-ClearSiteSystemServer]
[-DefaultSiteCode <String>]
[-Description <String>]
-Id <String>
[-NewName <String>]
[-PassThru]
[-PreferCloudDPOverDP <Boolean>]
[-PreferDPOverPeer <Boolean>]
[-RemoveSiteSystemServer <IResultObject[]>]
[-RemoveSiteSystemServerName <String[]>]
[-SubnetPeerDownloadOnly <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMBoundaryGroup
[-AddSiteSystemServer <IResultObject[]>]
[-AddSiteSystemServerName <String[]>]
[-AllowPeerDownload <Boolean>]
[-ClearSiteSystemServer]
[-DefaultSiteCode <String>]
[-Description <String>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-PreferCloudDPOverDP <Boolean>]
[-PreferDPOverPeer <Boolean>]
[-RemoveSiteSystemServer <IResultObject[]>]
[-RemoveSiteSystemServerName <String[]>]
[-SubnetPeerDownloadOnly <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Set-CMBoundaryGroup cmdlet 修改边界组的属性。 边界组是边界的集合。 有关详细信息，请参阅 定义站点边界和边界组 和 New-CMBoundary cmdlet。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：重命名边界组
此命令重命名边界组。 它使用 Get-CMBoundaryGroup cmdlet 获取边界组对象，然后使用管道运算符传递它。
Get-CMBoundaryGroup -Name "BGroup01" | Set-CMBoundaryGroup -NewName "BGroup00"示例 2：向边界组添加安全作用域
此命令将安全作用域 OSDeploymentScope 添加到边界组 BGroup02。
Set-CMBoundaryGroup -SecurityScopeAction AddMembership -SecurityScopeName "OSDeploymentScope" -Name "BGroup02"示例 3：添加站点系统服务器
此命令使用 Get-CMSiteSystemServer cmdlet 获取服务器对象，然后将其添加到边界组。
$server = Get-CMSiteSystemServer -Name "granitefalls.cloudapp.net"
Set-CMBoundaryGroup -Name "Remote BG" -AddSiteSystemServer $server参数
-AddSiteSystemServer
指定要添加到此边界组的站点系统服务器对象。 边界组中的客户端将这些服务器用于策略和内容。 可以添加管理点、分发点、状态迁移点、软件更新点和云管理网关。 若要获取站点系统服务器对象，请使用 Get-CMSiteSystemServer cmdlet。
| 类型: | IResultObject[] |
| 别名: | AddSiteSystemServers |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AddSiteSystemServerName
指定要添加到此边界组的站点系统服务器的完全限定域名。 边界组中的客户端将这些服务器用于策略和内容。 可以添加管理点、分发点、状态迁移点、软件更新点和云管理网关。
重要
此参数需要站点服务器的完全限定域名。
| 类型: | String[] |
| 别名: | AddSiteSystemServerNames |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllowPeerDownload
配置边界组选项以允许此边界组中的对等下载。 有关详细信息，请参阅 用于对等下载的边界组选项。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ClearSiteSystemServer
添加此参数以从边界组中删除所有引用的站点系统服务器。
| 类型: | SwitchParameter |
| 别名: | ClearSiteSystemServers |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultSiteCode
指定要设置为已分配站点的站点代码，并为站点分配启用边界组。
若要禁用边界组的站点分配，请将此值设置为 $null。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
为此边界组指定可选说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
指定要配置的边界组的 ID。 此 ID 是 SMS_BoundaryGroup 对象上的 GroupID 属性。 例如，33。
| 类型: | String |
| 别名: | GroupId |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定要配置的边界组的对象。 若要获取边界组对象，请使用 Get-CMBoundaryGroup cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
指定要配置的边界组的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-NewName
使用此参数重命名边界组。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PassThru
返回一个 对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PreferCloudDPOverDP
配置边界组选项，以优先使用基于云的源而不是本地源。 有关详细信息，请参阅 用于对等下载的边界组选项。
| 类型: | Boolean |
| 别名: | PreferCloudDistributionPointOverDistributionPoint |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PreferDPOverPeer
将边界组选项配置为优先选择分发点，而不是同一子网中的对等节点。 若要启用此设置，还需启用 -AllowPeerDownload。 有关详细信息，请参阅 用于对等下载的边界组选项。
| 类型: | Boolean |
| 别名: | PreferDistributionPointOverPeerInSubnet |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RemoveSiteSystemServer
指定要从边界组中删除的站点系统服务器对象。 若要获取此对象，请使用 Get-CMSiteSystemServer cmdlet。
若要删除所有站点系统服务器，请使用 -ClearSiteSystemServer 参数。
| 类型: | IResultObject[] |
| 别名: | RemoveSiteSystemServers |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RemoveSiteSystemServerName
指定要从边界组中删除的一个或多个站点系统服务器的名称。 若要删除所有站点系统服务器，请使用 -ClearSiteSystemServer 参数。
| 类型: | String[] |
| 别名: | RemoveSiteSystemServerNames |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SubnetPeerDownloadOnly
将边界组选项配置为在对等下载期间仅使用同一子网中的对等。 若要启用此设置，还需启用 -AllowPeerDownload。 有关详细信息，请参阅 用于对等下载的边界组选项。
| 类型: | Boolean |
| 别名: | PeerWithinSameSubnetOnly |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject