Set-CMBoundary
Настройте границу сайта.
Синтаксис
Set-CMBoundary
-InputObject <IResultObject>
[-NewName <String>]
[-NewType <BoundaryTypes>]
[-NewValue <String>]
[-PassThru]
[-ValueStartsWith <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMBoundary
-Id <String>
[-NewName <String>]
[-NewType <BoundaryTypes>]
[-NewValue <String>]
[-PassThru]
[-ValueStartsWith <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMBoundary
[-NewName <String>]
[-NewType <BoundaryTypes>]
[-NewValue <String>]
[-PassThru]
-Type <BoundaryTypes>
-Value <String>
[-ValueStartsWith <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот командлет для настройки границ сайта. Граница — это сетевое расположение, содержащее одно или несколько устройств, которыми можно управлять. Границей может быть IP-подсеть, имя сайта Active Directory, префикс IPv6, диапазон IP-адресов или VPN. Дополнительные сведения см. в разделе Определение границ сайта и групп границ.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Переименование границы
Эта команда изменяет имя границы с Default-ADSite на ADSiteBoundary01.
Set-CMBoundary -Name "Default-ADSite" -NewName "ADSiteBoundary01"
Пример 2. Изменение значения границы с помощью InputObject
В этом примере первая команда получает границу с идентификатором 16777217 и вставляет ее во входной объект $BoundaryObj.
Вторая команда определяет границу с помощью входного объекта $BoundaryObj и изменяет ее значение на IPSubnet17.
$BoundaryObj = Get-CMBoundary -Id "16777217"
Set-CMBoundary -InputObject $BoundaryObj -Value "IPSubnet17"
Параметры
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | 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
Укажите идентификатор границы для изменения. Это значение является целым числом, например 26.
| Тип: | String |
| Aliases: | BoundaryId |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Укажите объект границы для изменения. Чтобы получить этот объект, используйте командлет Get-CMBoundary .
| Тип: | IResultObject |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-NewName
Укажите новое имя границы.
| Тип: | String |
| Aliases: | DisplayName, Name |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NewType
Укажите тип границы.
| Тип: | BoundaryTypes |
| Aliases: | NewBoundaryType |
| Допустимые значения: | IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NewValue
Укажите данные, определяющие границу. Например, значение сайта Active Directory может иметь значение Default-First-Site-Name.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Type
Укажите тип границы.
| Тип: | BoundaryTypes |
| Aliases: | BoundaryType |
| Допустимые значения: | IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Value
Укажите данные, описывающие границу.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ValueStartsWith
Присвойте этому параметру значение , $true чтобы он соответствовал началу имени или описания подключения, а не всей строке. Дополнительные сведения см. в разделе Определение сетевых расположений в качестве границ.
| Тип: | Boolean |
| 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
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_Boundary класс WMI сервера.