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 コマンドレットを使用することもできます。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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
境界グループ名の配列を指定します。 コマンドレットは、これらの境界グループを状態移行ポイントに追加します。 移行中、境界グループ内のクライアントは、コンテンツのソースの場所としてこのサイトを使用します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AddStorageFolder
ストレージ フォルダーの配列をストレージ ディレクトリ データ オブジェクトとして指定します。 コマンドレットは、これらのフォルダーを状態移行ポイントに追加します。 ストレージ ディレクトリ データ オブジェクトを取得するには、 New-CMStoragefolder コマンドレットを使用します。
状態移行ポイントは、コンピューターを新しいオペレーティング システムに移行するときに、ユーザー状態データを格納します。
型: | StorageDirectoryData[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowFallbackSourceLocationForContent
フォールバック ソースの場所を使用できるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeleteImmediately
ターゲット コンピューターがそのデータをダウンロードした直後に、クライアント データの削除が発生することを示します。 $Falseの値を選択する場合は、 TimeDeleteAfter パラメーターと TimeUnit パラメーターを使用して待機する時間を指定します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnableRestoreOnlyMode
復元のみのモードを有効にするかどうかを示します。 復元のみのモードでは、Configuration Manager はクライアント データを格納するための新しい要求を拒否します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
状態移行ポイント オブジェクトを指定します。 状態移行ポイント オブジェクトを取得するには、 Get-CMStateMigrationPoint コマンドレットを 使用します。
型: | IResultObject |
Aliases: | StateMigrationPoint |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RemoveBoundaryGroupName
境界グループ名の配列を指定します。 コマンドレットは、状態移行ポイントからこれらの境界グループを削除します。 移行中、境界グループ内のクライアントは、コンテンツのソースの場所としてこのサイトを使用します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RemoveStorageFolder
ストレージ フォルダーの配列をストレージ ディレクトリ データ オブジェクトとして指定します。 コマンドレットは、状態移行ポイントからこれらのフォルダーを削除します。 状態移行ポイントは、コンピューターを新しいオペレーティング システムに移行するときに、ユーザー状態データを格納します。
型: | StorageDirectoryData[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SiteCode
Configuration Manager サイトのサイト コードを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SiteSystemServerName
状態移行ポイントのホスト名を指定します。
型: | String |
Aliases: | Name, ServerName |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TimeDeleteAfter
ターゲット コンピューターがデータをダウンロードしてデータを削除するまでの待機時間を指定します。 TimeUnit パラメーターを使用して時間単位を指定します。 データをすぐに削除するには、 DeleteImmediately パラメーターに $True の値を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TimeUnit
TimeDeleteAfter パラメーターで指定した値の時間単位を指定します。 このパラメーターで使用できる値は、日数と時間です。
型: | IntervalType |
指定可能な値: | Hours, Days |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject