Set-CMStateMigrationPoint
Configuration Manager の状態移行ポイントの設定を変更します。
構文
Set-CMStateMigrationPoint
[-AddBoundaryGroupName <String[]>]
[-AddStorageFolder <StorageDirectoryData[]>]
[-AllowFallbackSourceLocationForContent <Boolean>]
[-DeleteImmediately]
[-EnableRestoreOnlyMode <Boolean>]
-InputObject <IResultObject>
[-PassThru]
[-RemoveBoundaryGroupName <String[]>]
[-RemoveStorageFolder <StorageDirectoryData[]>]
[-TimeDeleteAfter <Int32>]
[-TimeUnit <IntervalType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMStateMigrationPoint
[-AddBoundaryGroupName <String[]>]
[-AddStorageFolder <StorageDirectoryData[]>]
[-AllowFallbackSourceLocationForContent <Boolean>]
[-DeleteImmediately]
[-EnableRestoreOnlyMode <Boolean>]
[-PassThru]
[-RemoveBoundaryGroupName <String[]>]
[-RemoveStorageFolder <StorageDirectoryData[]>]
[-SiteCode <String>]
[-SiteSystemServerName] <String>
[-TimeDeleteAfter <Int32>]
[-TimeUnit <IntervalType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-CMStateMigrationPoint コマンドレットは、Configuration Manager の状態移行ポイントの設定を変更します。 状態移行ポイントは、オペレーティング システムのインストール プロセス中にクライアント コンピューターからのデータ転送を管理するサイト システムの役割です。 このコマンドレットを使用して、移行ポイントに関連付けられている境界グループとストレージ フォルダー、移行ポイントがクライアント データを削除するまでの待機時間、コンテンツのフォールバック ソースの場所を許可するかどうか、復元のみモードを有効にするかどうかを変更します。
サイト システム サーバー名とサイト コードを使用して変更する移行ポイントを指定するか 、Get-CMStateMigrationPoint コマンドレットを使用 できます。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: 状態移行ポイントを変更する
PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit Hours
この例では、コード CM4 を持つサイト MigrationServer.TSQA.Contoso.com という名前の移行ポイントを変更します。 この例では、移行ポイントを変更してコンテンツのフォールバック ソースの場所を許可し、データのダウンロード後にデータを削除する時間を変更します。
最初のコマンドでは 、Get-CMStateMigrationPoint コマンドレットを使用して、指定したサイト コードとサーバー名の移行ポイントを取得し、$StateMigrationPoint 変数に格納します。
2 番目のコマンドは、変数に格納されている入力オブジェクト$StateMigrationPointします。 このコマンドは 、AllowFallbackSourceLocationForContent パラメーターを $True に設定し、削除する時間を 12 時間に変更します。
例 2: 状態移行ポイントの記憶域フォルダーと境界グループを変更する
PS XYZ:\> $Storage01 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte -StorageFolderName "C:\"
PS XYZ:\> $Storage02 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit Gigabyte -StorageFolderName "D:\"
PS XYZ:\> Set-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com" -AddBoundaryGroupName "BG07" -AddStorageFolder $Storage02 -AllowFallbackSourceLocationForContent $False -DeleteImmediately -EnableRestoreOnlyMode $True -RemoveBoundaryGroupName "BG22" -RemoveStorageFolder $Storage01
この例では、サイト コード CM4 を持つサイト MigrationServer.TSQA.Contoso.com という名前の状態移行ポイントの設定を変更します。 この例では、別の境界グループと異なる記憶域フォルダーを置き換え、他の設定を変更します。
最初のコマンドは 、New-CMStoragefolder コマンドレットを使用してストレージ フォルダー オブジェクトを作成し、$Storage 01 変数に格納します。 詳細については、そのコマンドレットのドキュメントを参照してください。
2 番目のコマンドは 、New-CMStoragefolder コマンドレットを使用してストレージ フォルダー オブジェクトを作成し、$Storage 02 変数に格納します。
3 番目のコマンドは、$Storage 01 変数に格納されているストレージ フォルダーを移行ポイントから削除し、同じコマンドで、$Storage 02 変数に格納されているストレージ フォルダーを移行ポイントに追加します。 同様に、このコマンドは BG22 という名前の境界グループを削除し、BG07 という名前の境界グループを追加します。 このコマンドでは 、AllowFallbackSourceLocationForContent パラメーターの $False の値と EnableRestoreOnlyMode パラメーターの $True の値も指定します。 このコマンドでは 、DeleteImmediately パラメーターを使用 します。そのため、移行ポイントはダウンロード後すぐにクライアント情報を削除します。
パラメーター
-AddBoundaryGroupName
境界グループ名の配列を指定します。 コマンドレットは、これらの境界グループを状態移行ポイントに追加します。 移行中、境界グループ内のクライアントは、コンテンツのソースの場所としてこのサイトを使用します。
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddStorageFolder
記憶域ディレクトリ データ オブジェクトとして、記憶域フォルダーの配列を指定します。 コマンドレットは、これらのフォルダーを状態移行ポイントに追加します。 記憶域ディレクトリ データ オブジェクトを取得するには 、New-CMStoragefolder コマンドレットを使用 します。
状態移行ポイントは、コンピューターを新しいオペレーティング システムに移行するときにユーザー状態データを格納します。
Type: | StorageDirectoryData[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowFallbackSourceLocationForContent
フォールバック ソースの場所が使用可能かどうかを示します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeleteImmediately
ターゲット コンピューターがデータをダウンロードした直後にクライアント データの削除が行われるかどうかを示します。 値を選択する場合は$False TimeDeleteAfter パラメーターと TimeUnit パラメーターを使用して待機する 時間を指定 します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableRestoreOnlyMode
復元専用モードを有効にするかどうかを示します。 復元のみモードでは、Configuration Manager はクライアント データを格納する新しい要求を拒否します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
状態移行ポイント オブジェクトを指定します。 状態移行ポイント オブジェクトを取得するには 、Get-CMStateMigrationPoint コマンドレットを使用 します。
Type: | IResultObject |
Aliases: | StateMigrationPoint |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveBoundaryGroupName
境界グループ名の配列を指定します。 コマンドレットは、これらの境界グループを状態移行ポイントから削除します。 移行中、境界グループ内のクライアントは、コンテンツのソースの場所としてこのサイトを使用します。
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveStorageFolder
記憶域ディレクトリ データ オブジェクトとして、記憶域フォルダーの配列を指定します。 コマンドレットは、これらのフォルダーを状態移行ポイントから削除します。 状態移行ポイントは、コンピューターを新しいオペレーティング システムに移行するときにユーザー状態データを格納します。
Type: | StorageDirectoryData[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
Configuration Manager サイトのサイト コードを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteSystemServerName
状態移行ポイントのホスト名を指定します。
Type: | String |
Aliases: | Name, ServerName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeDeleteAfter
ターゲット コンピューターがデータをダウンロードしてそのデータを削除するまでの待機時間を指定します。 TimeUnit パラメーターを使用して時間単位 を指定 します。 データをすぐに削除するには 、DeleteImmediately パラメーター$True値を指定します。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeUnit
TimeDeleteAfterパラメーターで指定された値の時間単位を指定します。 このパラメーターに使用できる値は、日と時間です。
Type: | IntervalType |
Accepted values: | Hours, Days |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject