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>] Description
Set-CMStateMigrationPoint cmdlet은 Configuration Manager의 상태 마이그레이션 지점에 대한 설정을 수정합니다. 상태 마이그레이션 지점은 운영 체제 설치 프로세스 중에 클라이언트 컴퓨터에서 데이터 전송을 관리하는 사이트 시스템 역할입니다. 이 cmdlet을 사용하여 마이그레이션 지점과 연결된 경계 그룹 및 스토리지 폴더, 마이그레이션 지점에서 클라이언트 데이터를 삭제할 때까지 대기하는 시간, 콘텐츠에 대한 대체 원본 위치를 허용할지 여부, 복원 전용 모드를 사용하도록 설정할지 여부를 수정합니다.
사이트 시스템 서버 이름 및 사이트 코드를 사용하여 수정할 마이그레이션 지점을 지정하거나 Get-CMStateMigrationPoint cmdlet을 사용할 수 있습니다.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 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 cmdlet을 사용하여 지정된 사이트 코드 및 서버 이름에 대한 마이그레이션 지점을 가져오고 $StateMigrationPoint 변수에 저장합니다.
두 번째 명령은 $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 cmdlet을 사용하여 스토리지 폴더 개체를 만들고 $Storage 01 변수에 저장합니다. 자세한 내용은 해당 cmdlet에 대한 설명서를 참조하세요.
두 번째 명령은 New-CMStoragefolder cmdlet을 사용하여 스토리지 폴더 개체를 만들고 $Storage 02 변수에 저장합니다.
세 번째 명령은 마이그레이션 지점에서 $Storage 01 변수에 저장된 스토리지 폴더를 제거하고 동일한 명령에서 $Storage 02 변수에 저장된 스토리지 폴더를 마이그레이션 지점에 추가합니다. 마찬가지로 명령은 BG22라는 경계 그룹을 제거하고 BG07이라는 경계 그룹을 추가합니다. 또한 이 명령은 AllowFallbackSourceLocationForContent 매개 변수에 대한 $False 값과 EnableRestoreOnlyMode 매개 변수에 대한 $True 값을 지정합니다. 명령은 DeleteImmediately 매개 변수를 사용합니다. 따라서 마이그레이션 지점은 다운로드 직후 클라이언트 정보를 삭제합니다.
매개 변수
-AddBoundaryGroupName
경계 그룹 이름의 배열을 지정합니다. cmdlet은 이러한 경계 그룹을 상태 마이그레이션 지점에 추가합니다. 마이그레이션하는 동안 경계 그룹의 클라이언트는 이 사이트를 콘텐츠의 원본 위치로 사용합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AddStorageFolder
스토리지 폴더의 배열을 스토리지 디렉터리 데이터 개체로 지정합니다. cmdlet은 이러한 폴더를 상태 마이그레이션 지점에 추가합니다. 스토리지 디렉터리 데이터 개체를 가져오려면 New-CMStoragefolder cmdlet을 사용합니다.
상태 마이그레이션 지점은 컴퓨터를 새 운영 체제로 마이그레이션할 때 사용자 상태 데이터를 저장합니다.
| 형식: | StorageDirectoryData[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AllowFallbackSourceLocationForContent
대체 원본 위치를 사용할 수 있는지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DeleteImmediately
대상 컴퓨터가 해당 데이터를 다운로드한 직후에 클라이언트 데이터가 삭제됨을 나타냅니다. $False 값을 선택하는 경우 TimeDeleteAfter 및 TimeUnit 매개 변수를 사용하여 대기할 시간을 지정합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableRestoreOnlyMode
복원 전용 모드를 사용하도록 설정할지 여부를 나타냅니다. 복원 전용 모드에서 Configuration Manager는 클라이언트 데이터 저장에 대한 새 요청을 거부합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
상태 마이그레이션 지점 개체를 지정합니다. 상태 마이그레이션 지점 개체를 가져오려면 Get-CMStateMigrationPoint cmdlet을 사용합니다.
| 형식: | IResultObject |
| 별칭: | StateMigrationPoint |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PassThru
작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RemoveBoundaryGroupName
경계 그룹 이름의 배열을 지정합니다. cmdlet은 상태 마이그레이션 지점에서 이러한 경계 그룹을 제거합니다. 마이그레이션하는 동안 경계 그룹의 클라이언트는 이 사이트를 콘텐츠의 원본 위치로 사용합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RemoveStorageFolder
스토리지 폴더의 배열을 스토리지 디렉터리 데이터 개체로 지정합니다. cmdlet은 상태 마이그레이션 지점에서 이러한 폴더를 제거합니다. 상태 마이그레이션 지점은 컴퓨터를 새 운영 체제로 마이그레이션할 때 사용자 상태 데이터를 저장합니다.
| 형식: | StorageDirectoryData[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SiteCode
Configuration Manager 사이트의 사이트 코드를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SiteSystemServerName
상태 마이그레이션 지점의 호스트 이름을 지정합니다.
| 형식: | String |
| 별칭: | Name, ServerName |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimeDeleteAfter
대상 컴퓨터가 해당 데이터를 삭제하기 위해 데이터를 다운로드한 후 대기할 시간을 지정합니다. TimeUnit 매개 변수를 사용하여 시간 단위를 지정합니다. 데이터를 즉시 삭제하려면 DeleteImmediately 매개 변수에 대한 $True 값을 지정합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimeUnit
TimeDeleteAfter 매개 변수에 지정된 값의 시간 단위를 지정합니다. 이 매개 변수에 허용되는 값은 일 및 시간입니다.
| 형식: | IntervalType |
| 허용되는 값: | Hours, Days |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
IResultObject