다음을 통해 공유

Set-CMStateMigrationPoint

  • 참조
모듈:
ConfigurationManager

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