Add-CMStateMigrationPoint

Add-CMStateMigrationPoint

Adds a state migration point in Configuration Manager.

構文

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

詳細説明

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.

パラメーター

-AllowFallbackSourceLocationForContent<Boolean>

Indicates whether a fallback source location is available.

-BoundaryGroupName<String[]>

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

-DeleteImmediately

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

-EnableRestoreOnlyMode<Boolean>

Indicates whether to enable restore only mode. If this mode is enabled, Configuration Manager refuses new requests to store client data.

-SiteCode<String>

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

-SiteSystemServerName<String>

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

-StorageFolders<StorageDirectoryData[]>

Specifies an array of storage folders.

-TimeDeleteAfter<Int32>

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

-TimeUnit<IntervalType>

Specifies the unit of time for the TimeDeleteAfter parameter. Valid values are: Days and Hours.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

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

関連トピック

Get-CMStateMigrationPoint

Remove-CMStateMigrationPoint

Set-CMStateMigrationPoint

Get-CMBoundaryGroup