Share via


Set-CMBoundaryGroup

경계 그룹의 속성을 수정합니다.

Syntax

Set-CMBoundaryGroup
   [-AddSiteSystemServer <IResultObject[]>]
   [-AddSiteSystemServerName <String[]>]
   [-AllowPeerDownload <Boolean>]
   [-ClearSiteSystemServer]
   [-DefaultSiteCode <String>]
   [-Description <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-PreferCloudDPOverDP <Boolean>]
   [-PreferDPOverPeer <Boolean>]
   [-RemoveSiteSystemServer <IResultObject[]>]
   [-RemoveSiteSystemServerName <String[]>]
   [-SubnetPeerDownloadOnly <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBoundaryGroup
   [-AddSiteSystemServer <IResultObject[]>]
   [-AddSiteSystemServerName <String[]>]
   [-AllowPeerDownload <Boolean>]
   [-ClearSiteSystemServer]
   [-DefaultSiteCode <String>]
   [-Description <String>]
   -Id <String>
   [-NewName <String>]
   [-PassThru]
   [-PreferCloudDPOverDP <Boolean>]
   [-PreferDPOverPeer <Boolean>]
   [-RemoveSiteSystemServer <IResultObject[]>]
   [-RemoveSiteSystemServerName <String[]>]
   [-SubnetPeerDownloadOnly <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBoundaryGroup
   [-AddSiteSystemServer <IResultObject[]>]
   [-AddSiteSystemServerName <String[]>]
   [-AllowPeerDownload <Boolean>]
   [-ClearSiteSystemServer]
   [-DefaultSiteCode <String>]
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-PreferCloudDPOverDP <Boolean>]
   [-PreferDPOverPeer <Boolean>]
   [-RemoveSiteSystemServer <IResultObject[]>]
   [-RemoveSiteSystemServerName <String[]>]
   [-SubnetPeerDownloadOnly <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-CMBoundaryGroup cmdlet은 경계 그룹의 속성을 수정합니다. 경계 그룹은 경계 컬렉션입니다. 자세한 내용은 사이트 경계 및 경계 그룹 정의 및New-CMBoundary cmdlet을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 경계 그룹 이름 바꾸기

이 명령은 경계 그룹의 이름을 바꿉니다. Get-CMBoundaryGroup cmdlet을 사용하여 경계 그룹 개체를 가져온 다음 파이프라인 연산자를 사용하여 전달합니다.

Get-CMBoundaryGroup -Name "BGroup01" | Set-CMBoundaryGroup -NewName "BGroup00"

예제 2: 경계 그룹에 보안 범위 추가

이 명령은 경계 그룹 BGroup02에 보안 범위 OSDeploymentScope를 추가합니다.

Set-CMBoundaryGroup -SecurityScopeAction AddMembership -SecurityScopeName "OSDeploymentScope" -Name "BGroup02"

예제 3: 사이트 시스템 서버 추가

이 명령은 Get-CMSiteSystemServer cmdlet을 사용하여 서버 개체를 가져온 다음 경계 그룹에 추가합니다.

$server = Get-CMSiteSystemServer -Name "granitefalls.cloudapp.net"
Set-CMBoundaryGroup -Name "Remote BG" -AddSiteSystemServer $server

매개 변수

-AddSiteSystemServer

이 경계 그룹에 추가할 사이트 시스템 서버 개체를 지정합니다. 경계 그룹의 클라이언트는 정책 및 콘텐츠에 이러한 서버를 사용합니다. 관리 지점, 배포 지점, 상태 마이그레이션 지점, 소프트웨어 업데이트 지점 및 클라우드 관리 게이트웨이를 추가할 수 있습니다. 사이트 시스템 서버 개체를 얻으려면 Get-CMSiteSystemServer cmdlet을 사용합니다.

Type:IResultObject[]
Aliases:AddSiteSystemServers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddSiteSystemServerName

이 경계 그룹에 추가할 사이트 시스템 서버의 정규화된 도메인 이름을 지정합니다. 경계 그룹의 클라이언트는 정책 및 콘텐츠에 이러한 서버를 사용합니다. 관리 지점, 배포 지점, 상태 마이그레이션 지점, 소프트웨어 업데이트 지점 및 클라우드 관리 게이트웨이를 추가할 수 있습니다.

중요

이 매개 변수에는 사이트 서버의 정규화된 도메인 이름이 필요합니다.

Type:String[]
Aliases:AddSiteSystemServerNames
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowPeerDownload

이 경계 그룹에서 피어 다운로드를 허용하도록 경계 그룹 옵션을 구성합니다. 자세한 내용은 피어 다운로드에 대한 경계 그룹 옵션을 참조하세요.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearSiteSystemServer

이 매개 변수를 추가하여 경계 그룹에서 참조된 모든 사이트 시스템 서버를 제거합니다.

Type:SwitchParameter
Aliases:ClearSiteSystemServers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultSiteCode

할당된 사이트로 설정할 사이트 코드를 지정하고 사이트 할당에 경계 그룹을 사용하도록 설정합니다.

경계 그룹에 대한 사이트 할당을 사용하지 않도록 설정하려면 이 값을 로 $null설정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

이 경계 그룹에 대한 선택적 설명을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

구성할 경계 그룹의 ID를 지정합니다. 이 ID는 SMS_BoundaryGroup 개체의 GroupID 속성입니다. 예를 들면 33와 같습니다.

Type:String
Aliases:GroupId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

구성할 경계 그룹의 개체를 지정합니다. 경계 그룹 개체를 가져오려면 Get-CMBoundaryGroup cmdlet을 사용합니다.

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

구성할 경계 그룹의 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NewName

이 매개 변수를 사용하여 경계 그룹의 이름을 바꿉니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferCloudDPOverDP

온-프레미스 원본보다 클라우드 기반 원본을 선호하도록 경계 그룹 옵션을 구성합니다. 자세한 내용은 피어 다운로드에 대한 경계 그룹 옵션을 참조하세요.

Type:Boolean
Aliases:PreferCloudDistributionPointOverDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferDPOverPeer

동일한 서브넷 내의 피어보다 배포 지점을 선호하도록 경계 그룹 옵션을 구성합니다. 이 설정을 사용하도록 설정하려면 -AllowPeerDownload도 사용하도록 설정합니다. 자세한 내용은 피어 다운로드에 대한 경계 그룹 옵션을 참조하세요.

Type:Boolean
Aliases:PreferDistributionPointOverPeerInSubnet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveSiteSystemServer

경계 그룹에서 제거할 사이트 시스템 서버 개체를 지정합니다. 이 개체를 얻으려면 Get-CMSiteSystemServer cmdlet을 사용합니다.

모든 사이트 시스템 서버를 제거하려면 -ClearSiteSystemServer 매개 변수를 사용합니다.

Type:IResultObject[]
Aliases:RemoveSiteSystemServers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveSiteSystemServerName

경계 그룹에서 제거할 하나 이상의 사이트 시스템 서버의 이름을 지정합니다. 모든 사이트 시스템 서버를 제거하려면 -ClearSiteSystemServer 매개 변수를 사용합니다.

Type:String[]
Aliases:RemoveSiteSystemServerNames
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetPeerDownloadOnly

피어 다운로드 중에 동일한 서브넷 내의 피어만 사용하도록 경계 그룹 옵션을 구성합니다. 이 설정을 사용하도록 설정하려면 -AllowPeerDownload도 사용하도록 설정합니다. 자세한 내용은 피어 다운로드에 대한 경계 그룹 옵션을 참조하세요.

Type:Boolean
Aliases:PeerWithinSameSubnetOnly
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject