Add-CMStateMigrationPoint

Add-CMStateMigrationPoint

Adds a state migration point in Configuration Manager.

Syntax

Parameter Set: StateMigrationPointWithDeletionAfter
Add-CMStateMigrationPoint -AllowFallbackSourceLocationForContent <Boolean> -EnableRestoreOnlyMode <Boolean> -SiteCode <String> -SiteSystemServerName <String> -StorageFolders <StorageDirectoryData[]> -TimeDeleteAfter <Int32> -TimeUnit <IntervalType> {Days | Hours} [-BoundaryGroupName <String[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: StateMigrationPointWithImmediation
Add-CMStateMigrationPoint -AllowFallbackSourceLocationForContent <Boolean> -EnableRestoreOnlyMode <Boolean> -SiteCode <String> -SiteSystemServerName <String> -StorageFolders <StorageDirectoryData[]> [-BoundaryGroupName <String[]> ] [-DeleteImmediately] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The Add-CMStateMigrationPoint cmdlet adds a state migration point in Microsoft System Center 2012 SP1 Configuration Manager. A state migration point is a site system role that manages data transfer from client computers during an operating system installation process.

Parameters

-AllowFallbackSourceLocationForContent<Boolean>

Indicates whether a fallback source location is available.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-BoundaryGroupName<String[]>

Specifies an array of names of boundary groups. You can get a boundary group name by using the Get-CMBoundaryGroup cmdlet.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeleteImmediately

Indicates that Configuration Manager deletes client data immediately after the target computer downloads the data.


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. If this mode is enabled, Configuration Manager refuses new requests to store client data.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

Specifies the Configuration Manager site that hosts this site system role.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteSystemServerName<String>

Specifies the name of the site system server in Configuration Manager.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-StorageFolders<StorageDirectoryData[]>

Specifies an array of storage folders.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-TimeDeleteAfter<Int32>

Specifies a time interval to wait before client data is deleted.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-TimeUnit<IntervalType>

Specifies the unit of time for the TimeDeleteAfter parameter. The acceptable values for this parameter are: Days and Hours.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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


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 (http://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: Add a state migration point

The first command creates a storage folder on the C: drive that has a maximum number of clients setting and a minimum free space setting. The command stores the result in the $s1 variable.

The second command creates a storage folder on the D: drive that has a maximum number of clients setting and a minimum free space setting. The command stores the result in the $s2 variable.

The third command adds a state migration point.


PS C:\> $s1 = New-CMStoragefolder -StorageFolderName "C:\Sto-1" -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte
PS C:\> $s2 = New-CMStoragefolder -StorageFolderName "D:\Sto-2" -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit Gigabyte
PS C:\> Add-CMStateMigrationPoint -SiteSystemServerName "Contoso-Migration.Contoso.com" -SiteCode "CM2" -StorageFolders $s1,$s2 -DeleteImmediately -EnableRestoreOnlyMode $False -AllowFallbackSourceLocationForContent $False -BoundaryGroupName "CMC"

Related topics

Community Additions

ADD
Show: