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 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 Managerdeletes 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. Valid 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 (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: Add a state migration point
This example specifies new storage folders for the data and adds a new migration state point by using the new storage folders.
The first command creates new a storage folder on the C: drive with 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 new a storage folder on the D: drive with 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 MegabytePS C:\> $s2 = New-CMStoragefolder -StorageFolderName "D:\Sto-2" -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit GigabytePS C:\> Add-CMStateMigrationPoint -SiteSystemName "Contoso-Migration.Contoso.com" -SiteCode "CM2" -Storagefolder $s1,$s2 -DeleteImmediately -EnableRestoreOnlyMode $False -AllowFallbackSourceLocationForContent $False -BoudaryGroupName "CMC"