Set-CMStateMigrationPoint
Изменяет параметры для точки миграции состояния в Configuration Manager.
Синтаксис
Set-CMStateMigrationPoint
[-AddBoundaryGroupName <String[]>]
[-AddStorageFolder <StorageDirectoryData[]>]
[-AllowFallbackSourceLocationForContent <Boolean>]
[-DeleteImmediately]
[-EnableRestoreOnlyMode <Boolean>]
-InputObject <IResultObject>
[-PassThru]
[-RemoveBoundaryGroupName <String[]>]
[-RemoveStorageFolder <StorageDirectoryData[]>]
[-TimeDeleteAfter <Int32>]
[-TimeUnit <IntervalType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMStateMigrationPoint
[-AddBoundaryGroupName <String[]>]
[-AddStorageFolder <StorageDirectoryData[]>]
[-AllowFallbackSourceLocationForContent <Boolean>]
[-DeleteImmediately]
[-EnableRestoreOnlyMode <Boolean>]
[-PassThru]
[-RemoveBoundaryGroupName <String[]>]
[-RemoveStorageFolder <StorageDirectoryData[]>]
[-SiteCode <String>]
[-SiteSystemServerName] <String>
[-TimeDeleteAfter <Int32>]
[-TimeUnit <IntervalType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Командлет Set-CMStateMigrationPoint изменяет параметры точки миграции состояния в Configuration Manager. Точка миграции состояния — это роль системы сайта, которая управляет передачей данных с клиентских компьютеров в процессе установки операционной системы. Используйте этот командлет для изменения групп границ и папок хранения, связанных с точкой миграции, времени ожидания, прежде чем точка миграции удаляет данные клиента, разрешения резервного исходного расположения для содержимого и включения режима только восстановления.
Вы можете указать, какую точку миграции следует изменить, используя имя сервера системы сайта и код сайта или командлет Get-CMStateMigrationPoint .
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Изменение точки миграции состояния
PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit HoursВ этом примере изменяется точка миграции с именем MigrationServer.TSQA.Contoso.com для сайта с кодом CM4. В примере изменяется точка миграции, чтобы разрешить резервное исходное расположение для содержимого, и изменяется время после загрузки данных для удаления данных.
Первая команда использует командлет Get-CMStateMigrationPoint для получения точки миграции для указанного кода сайта и имени сервера и сохраняет ее в переменной $StateMigrationPoint.
Вторая команда изменяет входной объект, хранящийся в переменной $StateMigrationPoint. Команда задает параметр AllowFallbackSourceLocationForContent $True и изменяет время удаления через 12 часов.
Пример 2. Изменение папок хранилища и групп границ для точки миграции состояния
PS XYZ:\> $Storage01 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte -StorageFolderName "C:\"
PS XYZ:\> $Storage02 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit Gigabyte -StorageFolderName "D:\"
PS XYZ:\> Set-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com" -AddBoundaryGroupName "BG07" -AddStorageFolder $Storage02 -AllowFallbackSourceLocationForContent $False -DeleteImmediately -EnableRestoreOnlyMode $True -RemoveBoundaryGroupName "BG22" -RemoveStorageFolder $Storage01В этом примере изменяются параметры для точки миграции состояния с именем MigrationServer.TSQA.Contoso.com для сайта с кодом сайта CM4. В этом примере заменяется другая группа границ и другая папка хранения, а также изменяются другие параметры.
Первая команда использует командлет New-CMStoragefolder для создания объекта папки хранилища и сохраняет его в переменной $Storage 01. Дополнительные сведения см. в документации по командлету.
Вторая команда использует командлет New-CMStoragefolder для создания объекта папки хранилища и сохраняет его в переменной $Storage 02.
Третья команда удаляет папку хранилища, хранящуюся в переменной $Storage 01, из точки миграции и в той же команде добавляет папку хранилища, хранящуюся в переменной $Storage 02, в точку миграции. Аналогичным образом команда удаляет группу границ с именем BG22 и добавляет группу границ С именем BG07. Команда также задает значение $False для параметра AllowFallbackSourceLocationForContent и значение $True для параметра EnableRestoreOnlyMode . Команда использует параметр DeleteImmediately ; Таким образом, точка миграции удаляет сведения о клиенте сразу после скачивания.
Параметры
-AddBoundaryGroupName
Задает массив имен групп границ. Командлет добавляет эти группы границ в точку миграции состояния. Во время миграции клиенты в группе границ используют этот сайт в качестве исходного расположения для содержимого.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AddStorageFolder
Задает массив папок хранения в качестве объектов данных каталога хранилища. Командлет добавляет эти папки в точку миграции состояния. Чтобы получить объект данных каталога хранилища, используйте командлет New-CMStoragefolder .
Точка миграции состояния хранит данные о пользовательском состоянии при переносе компьютера в новую операционную систему.
| Тип: | StorageDirectoryData[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AllowFallbackSourceLocationForContent
Указывает, доступно ли резервное исходное расположение.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DeleteImmediately
Указывает, что удаление данных клиента происходит сразу после того, как целевой компьютер загрузит эти данные. Если выбрано значение $False, укажите время ожидания с помощью параметров TimeDeleteAfter и TimeUnit .
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EnableRestoreOnlyMode
Указывает, следует ли включить режим только для восстановления. В режиме только восстановления Configuration Manager отказывается от новых запросов на хранение данных клиента.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Указывает объект точки миграции состояния. Чтобы получить объект точки миграции состояния, используйте командлет Get-CMStateMigrationPoint .
| Тип: | IResultObject |
| Aliases: | StateMigrationPoint |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RemoveBoundaryGroupName
Задает массив имен групп границ. Командлет удаляет эти группы границ из точки миграции состояния. Во время миграции клиенты в группе границ используют этот сайт в качестве исходного расположения для содержимого.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RemoveStorageFolder
Задает массив папок хранения в качестве объектов данных каталога хранилища. Командлет удаляет эти папки из точки миграции состояния. Точка миграции состояния хранит данные о пользовательском состоянии при переносе компьютера в новую операционную систему.
| Тип: | StorageDirectoryData[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SiteCode
Указывает код сайта для сайта Configuration Manager.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SiteSystemServerName
Указывает имя узла для точки миграции состояния.
| Тип: | String |
| Aliases: | Name, ServerName |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TimeDeleteAfter
Указывает время ожидания после того, как целевой компьютер загрузит данные для удаления этих данных. Укажите единицу времени с помощью параметра TimeUnit . Чтобы удалить данные немедленно, укажите значение $True для параметра DeleteImmediately .
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TimeUnit
Задает единицу времени для значения, указанного в параметре TimeDeleteAfter . Допустимые значения для этого параметра: Дни и Часы.
| Тип: | IntervalType |
| Допустимые значения: | Hours, Days |
| 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