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