Set-CMBoundaryGroup

  • 参考
模块:
ConfigurationManager

修改边界组的属性。

语法

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。

Type:IResultObject[]
Aliases:AddSiteSystemServers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddSiteSystemServerName

指定要添加到此边界组的站点系统服务器的完全限定域名。 边界组中的客户端将这些服务器用于策略和内容。 可以添加管理点、分发点、状态迁移点、软件更新点和云管理网关。

重要

此参数需要站点服务器的完全限定域名。

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

-AllowPeerDownload

配置边界组选项以允许此边界组中的对等下载。 有关详细信息，请参阅 用于对等下载的边界组选项。

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

-ClearSiteSystemServer

添加此参数以从边界组中删除所有引用的站点系统服务器。

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

-Confirm

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

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

-DefaultSiteCode

指定要设置为已分配站点的站点代码，并为站点分配启用边界组。

若要禁用边界组的站点分配，请将此值设置为 $null。

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

-Description

为此边界组指定可选说明。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

指定要配置的边界组的 ID。 此 ID 是 SMS_BoundaryGroup 对象上的 GroupID 属性。 例如，33。

Type:String
Aliases:GroupId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

指定要配置的边界组的对象。 若要获取边界组对象，请使用 Get-CMBoundaryGroup cmdlet。

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

-Name

指定要配置的边界组的名称。

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

-NewName

使用此参数重命名边界组。

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

-PassThru

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

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

-PreferCloudDPOverDP

配置边界组选项，以优先使用基于云的源而不是本地源。 有关详细信息，请参阅 用于对等下载的边界组选项。

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

-PreferDPOverPeer

将边界组选项配置为优先选择分发点，而不是同一子网中的对等节点。 若要启用此设置，还需启用 -AllowPeerDownload。 有关详细信息，请参阅 用于对等下载的边界组选项。

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

-RemoveSiteSystemServer

指定要从边界组中删除的站点系统服务器对象。 若要获取此对象，请使用 Get-CMSiteSystemServer cmdlet。

若要删除所有站点系统服务器，请使用 -ClearSiteSystemServer 参数。

Type:IResultObject[]
Aliases:RemoveSiteSystemServers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveSiteSystemServerName

指定要从边界组中删除的一个或多个站点系统服务器的名称。 若要删除所有站点系统服务器，请使用 -ClearSiteSystemServer 参数。

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

-SubnetPeerDownloadOnly

将边界组选项配置为在对等下载期间仅使用同一子网中的对等。 若要启用此设置，还需启用 -AllowPeerDownload。 有关详细信息，请参阅 用于对等下载的边界组选项。

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject