Set-CMStateMigrationPoint

Set-CMStateMigrationPoint

Modifies settings for a state migration point in Configuration Manager.

Syntax

Parameter Set: SetByName
Set-CMStateMigrationPoint -SiteCode <String> -SiteSystemServerName <String> [-AddBoundaryGroupName <String[]> ] [-AddStorageFolder <StorageDirectoryData[]> ] [-AllowFallbackSourceLocationForContent <Boolean> ] [-DeleteImmediately] [-EnableRestoreOnlyMode <Boolean> ] [-RemoveBoundaryGroupName <String[]> ] [-RemoveStorageFolder <StorageDirectoryData[]> ] [-TimeDeleteAfter <Int32> ] [-TimeUnit <IntervalType> {Days | Hours} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetByValue
Set-CMStateMigrationPoint -InputObject <IResultObject> [-AddBoundaryGroupName <String[]> ] [-AddStorageFolder <StorageDirectoryData[]> ] [-AllowFallbackSourceLocationForContent <Boolean> ] [-DeleteImmediately] [-EnableRestoreOnlyMode <Boolean> ] [-RemoveBoundaryGroupName <String[]> ] [-RemoveStorageFolder <StorageDirectoryData[]> ] [-TimeDeleteAfter <Int32> ] [-TimeUnit <IntervalType> {Days | Hours} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-CMStateMigrationPoint cmdlet modifies settings for a state migration point in Microsoft System Center 2012 Configuration Manager. A state migration point is a site system role that manages data transfer from client computers during an operating system installation process. Use this cmdlet to modify the boundary groups and storage folders associated with the migration point, how long to wait before the migration point deletes client data, whether to allow a fallback source location for content, and whether to enable restore only mode.

You can specify which migration point to modify by using the site system server name and the site code, or use the Get-CMStateMigrationPoint cmdlet.

Parameters

-AddBoundaryGroupName<String[]>

Specifies an array of boundary group names. The cmdlet adds these boundary groups to the state migration point. During migration, clients in a boundary group use this site as a source location for content.

-AddStorageFolder<StorageDirectoryData[]>

Specifies an array of storage folders, as storage directory data objects. The cmdlet adds these folders to the state migration point. To obtain a storage directory data object, use the New-CMStoragefolder cmdlet.

A state migration point stores user state data when it migrates a computer to a new operating system.

-AllowFallbackSourceLocationForContent<Boolean>

Indicates whether a fallback source location is available.

-DeleteImmediately

Indicates that deletion of client data occurs immediately after the target computer downloads that data. If you select a value of $False, specify how long to wait by using the TimeDeleteAfter and TimeUnit parameters.

-EnableRestoreOnlyMode<Boolean>

Indicates whether to enable restore only mode. In restore only mode, Configuration Manager refuses new requests to store client data.

-InputObject<IResultObject>

Specifies a state migration point object. To obtain a state migration point object, use the Get-CMStateMigrationPoint cmdlet.

-RemoveBoundaryGroupName<String[]>

Specifies an array of boundary group names. The cmdlet removes these boundary groups from the state migration point. During migration, clients in a boundary group use this site as a source location for content.

-RemoveStorageFolder<StorageDirectoryData[]>

Specifies an array of storage folders, as storage directory data objects. The cmdlet removes these folders from the state migration point. A state migration point stores user state data when it migrates a computer to a new operating system.

-SiteCode<String>

Specifies the site code for a Configuration Manager site.

-SiteSystemServerName<String>

Specifies the host name for a state migration point.

-TimeDeleteAfter<Int32>

Specifies the amount of time to wait after the target computer downloads data to delete that data. Specify a time unit by using the TimeUnit parameter. To delete data immediately, specify a value of $True for the DeleteImmediately parameter.

-TimeUnit<IntervalType>

Specifies a time unit for the value specified in the TimeDeleteAfter parameter. The acceptable values for this parameter are: Days and Hours.

-Confirm

Prompts you for confirmation before running the cmdlet.

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Modify a state migration point

This example modifies a migration point named MigrationServer.Western.Contoso.com for the site that has the code CM4. The example changes the migration point to allow a fallback source location for content, and modifies how long after data download to delete data.

The first command uses the Get-CMStateMigrationPoint cmdlet to obtain a migration point for the specified site code and server name, and stores it in the $StateMigrationPoint variable.

The second command modifies the input object stored in the $StateMigrationPoint variable. The command sets the AllowFallbackSourceLocationForContent parameter to $True, and modifies the time to delete after to 12 hours.

PS C:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.Western.Contoso.com" 
PS C:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit Hours

Example 2: Modify storage folders and boundary groups for a state migration point

This example modifies settings for a state migration point named MigrationServer.Western.Contoso.com for the site that has the site code CM4. The example substitutes a different boundary group and different storage folder, and modifies other settings.

The first command uses the New-CMStoragefolder cmdlet to create a storage folder object, and stores it in the $Storage01 variable. Consult documentation for that cmdlet for details.

The second command uses the New-CMStoragefolder cmdlet to create a storage folder object, and stores it in the $Storage02 variable.

The third command removes the storage folder stored in the $Storage01 variable from the migration point and, in the same command, adds the storage folder stored in the $Storage02 variable to the migration point. Likewise, the command removes the boundary group named BG22 and adds the boundary group named BG07. The command also specifies a value of $False for the AllowFallbackSourceLocationForContent parameter and a value of $True for the EnableRestoreOnlyMode parameter. The command uses the DeleteImmediately parameter; therefore, the migration point deletes client information immediately after download.

PS C:\> $Storage01 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte -StorageFolderName "C:\"
PS C:\> $Storage02 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit Gigabyte -StorageFolderName "D:\"
PS C:\> Set-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.Western.Contoso.com" -AddBoundaryGroupName "BG07" -AddStorageFolder $Storage02 -AllowFallbackSourceLocationForContent $False -DeleteImmediately -EnableRestoreOnlyMode $True -RemoveBoundaryGroupName "BG22" -RemoveStorageFolder $Storage01

Related topics

Add-CMStateMigrationPoint

Get-CMStateMigrationPoint

Remove-CMStateMigrationPoint

New-CMStoragefolder