Export (0) Print
Expand All
Expand Minimize

Set-CMStateMigrationPoint

Updated: February 7, 2014

Applies To: System Center 2012 R2 Configuration Manager

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowFallbackSourceLocationForContent<Boolean>

Indicates whether a fallback source location is available.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableRestoreOnlyMode<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

Specifies the site code for a Configuration Manager site.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteSystemServerName<String>

Specifies the host name for a state migration point.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-TimeUnit<IntervalType>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

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

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft