共用方式為

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>]

Description

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

指定要設定之界限群組的標識碼。 此標識碼是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