Поделиться через

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 изменяет свойства группы границ. Группа границ — это коллекция границ. Дополнительные сведения см. в разделе Определение границ сайта и групп границ и командлет New-CMBoundary .

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Переименование группы границ

Эта команда переименовывает группу границ. Он использует командлет Get-CMBoundaryGroup для получения объекта группы границ, а затем передает его с помощью оператора конвейера.

Get-CMBoundaryGroup -Name "BGroup01" | Set-CMBoundaryGroup -NewName "BGroup00"

Пример 2. Добавление области безопасности в группу границ

Эта команда добавляет область безопасности OSDeploymentScope в группу границ BGroup02.

Set-CMBoundaryGroup -SecurityScopeAction AddMembership -SecurityScopeName "OSDeploymentScope" -Name "BGroup02"

Пример 3. Добавление сервера системы сайта

Эта команда использует командлет Get-CMSiteSystemServer для получения объекта сервера, а затем добавляет его в группу границ.

$server = Get-CMSiteSystemServer -Name "granitefalls.cloudapp.net"
Set-CMBoundaryGroup -Name "Remote BG" -AddSiteSystemServer $server

Параметры

-AddSiteSystemServer

Укажите объект сервера системы сайта для добавления в эту группу границ. Клиенты в группе границ используют эти серверы для политики и содержимого. Вы можете добавлять точки управления, точки распространения, точки миграции состояния, точки обновления программного обеспечения и шлюзы управления облаком. Чтобы получить объект сервера системы сайта, используйте командлет Get-CMSiteSystemServer .

Тип:IResultObject[]
Aliases:AddSiteSystemServers
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddSiteSystemServerName

Укажите полное доменное имя сервера системы сайта, добавляемого в эту группу границ. Клиенты в группе границ используют эти серверы для политики и содержимого. Вы можете добавлять точки управления, точки распространения, точки миграции состояния, точки обновления программного обеспечения и шлюзы управления облаком.

Важно!

Для этого параметра требуется полное доменное имя сервера сайта.

Тип:String[]
Aliases:AddSiteSystemServerNames
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowPeerDownload

Настройте параметр группы границ, чтобы разрешить загрузку одноранговых узлов в этой группе границ. Дополнительные сведения см. в разделе Параметры группы границ для одноранговых скачиваний.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ClearSiteSystemServer

Добавьте этот параметр, чтобы удалить из группы границ все серверы системы сайта, на которые ссылается ссылка.

Тип:SwitchParameter
Aliases:ClearSiteSystemServers
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultSiteCode

Укажите код сайта, который нужно задать в качестве назначенного сайта, и включите группу границ для назначения сайта.

Чтобы отключить назначение сайта для группы границ, задайте для этого значения $nullзначение .

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Укажите необязательное описание для этой группы границ.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

Укажите идентификатор настраиваемой группы границ. Этот идентификатор является свойством GroupID объекта SMS_BoundaryGroup . Например, 33.

Тип:String
Aliases:GroupId
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Укажите объект для настраиваемой группы границ. Чтобы получить объект группы границ, используйте командлет Get-CMBoundaryGroup .

Тип:IResultObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Укажите имя настраиваемой группы границ.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NewName

Используйте этот параметр для переименования группы границ.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PassThru

Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PreferCloudDPOverDP

Настройте параметр группы границ, чтобы предпочесть облачные источники, а не локальные. Дополнительные сведения см. в разделе Параметры группы границ для одноранговых скачиваний.

Тип:Boolean
Aliases:PreferCloudDistributionPointOverDistributionPoint
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PreferDPOverPeer

Настройте параметр группы границ, чтобы предпочесть точки распространения одноранговым узлам в одной подсети. Чтобы включить этот параметр, также включите параметр -AllowPeerDownload. Дополнительные сведения см. в разделе Параметры группы границ для одноранговых скачиваний.

Тип:Boolean
Aliases:PreferDistributionPointOverPeerInSubnet
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveSiteSystemServer

Указывает объект сервера системы сайта, удаляемый из группы границ. Чтобы получить этот объект, используйте командлет Get-CMSiteSystemServer .

Чтобы удалить все серверы системы сайта, используйте параметр -ClearSiteSystemServer .

Тип:IResultObject[]
Aliases:RemoveSiteSystemServers
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveSiteSystemServerName

Указывает имя одного или нескольких серверов системы сайта, которые необходимо удалить из группы границ. Чтобы удалить все серверы системы сайта, используйте параметр -ClearSiteSystemServer .

Тип:String[]
Aliases:RemoveSiteSystemServerNames
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SubnetPeerDownloadOnly

Настройте параметр группы границ так, чтобы во время загрузки одноранговых узлов использовались только одноранговые узлы в одной подсети. Чтобы включить этот параметр, также включите параметр -AllowPeerDownload. Дополнительные сведения см. в разделе Параметры группы границ для одноранговых скачиваний.

Тип:Boolean
Aliases:PeerWithinSameSubnetOnly
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

IResultObject