Set-CMBoundaryGroup

モジュール:

ConfigurationManager

境界グループのプロパティを変更します。

構文

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>]

説明

Set-CMBoundaryGroup コマンドレットは、境界グループのプロパティを変更します。 境界グループは、境界のコレクションです。 詳細については、「サイト境界と 境界グループの 定義」および 「New-CMBoundary コマンドレット」を参照 してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: 境界グループの名前を変更する

このコマンドは、境界グループの名前を変更します。 このコマンドレットは、Get-CMBoundaryGroupコマンドレットを使用して境界グループ オブジェクトを取得し、パイプライン 演算子を使用して渡します。

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

例 2: 境界グループにセキュリティ スコープを追加する

このコマンドは、セキュリティ スコープ OSDeploymentScope を 境界グループ BGroup02 に追加します。

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

例 3: サイト システム サーバーを追加する

このコマンドは 、Get-CMSiteSystemServer コマンドレットを使用してサーバー オブジェクトを取得し、境界グループに追加します。

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

パラメーター

-AddSiteSystemServer

この境界グループに追加するサイト システム サーバー オブジェクトを指定します。 境界グループ上のクライアントは、ポリシーとコンテンツにこれらのサーバーを使用します。 管理ポイント、配布ポイント、状態移行ポイント、ソフトウェア更新ポイント、クラウド管理ゲートウェイを追加できます。 サイト システム サーバー オブジェクトを取得するには 、Get-CMSiteSystemServer コマンドレットを使用 します。

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

-AddSiteSystemServerName

この境界グループに追加するサイト システム サーバーの完全修飾ドメイン名を指定します。 境界グループ上のクライアントは、ポリシーとコンテンツにこれらのサーバーを使用します。 管理ポイント、配布ポイント、状態移行ポイント、ソフトウェア更新ポイント、クラウド管理ゲートウェイを追加できます。

重要

このパラメーターには、サイト サーバーの完全修飾ドメイン名が必要です。

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

-AllowPeerDownload

境界グループ オプションを構成して、この境界グループ内のピア ダウンロードを許可します。 詳細については、「ピア ダウンロードの 境界グループ オプション」を参照してください。

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

-ClearSiteSystemServer

境界グループから参照されているサイト システム サーバーを削除するには、このパラメーターを追加します。

Type:	SwitchParameter
Aliases:	ClearSiteSystemServers
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

-DefaultSiteCode

割り当てられたサイトとして設定するサイト コードを指定し、サイト割り当ての境界グループを有効にする。

境界グループのサイト割り当てを無効にするには、この値をに設定します $null 。

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

-Description

この境界グループの説明を省略可能に指定します。

Type:	String
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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

-Id

構成する境界グループの ID を指定します。 この ID は、 オブジェクトの GroupID プロパティSMS_BoundaryGroup です。 たとえば、33 などです。

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

-InputObject

構成する境界グループのオブジェクトを指定します。 境界グループ オブジェクトを取得するには 、Get-CMBoundaryGroup コマンドレットを使用 します。

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

-Name

構成する境界グループの名前を指定します。

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

-NewName

境界グループの名前を変更するには、このパラメーターを使用します。

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

-PassThru

作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

-PreferCloudDPOverDP

オンプレミスのソースよりもクラウドベースのソースを優先する境界グループ オプションを構成します。 詳細については、「ピア ダウンロードの 境界グループ オプション」を参照してください。

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

-PreferDPOverPeer

同じサブネット内のピアよりも配布ポイントを優先する境界グループ オプションを構成します。 この設定を有効にするには 、-AllowPeerDownload も有効にします。 詳細については、「ピア ダウンロードの 境界グループ オプション」を参照してください。

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

-RemoveSiteSystemServer

境界グループから削除するサイト システム サーバー オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMSiteSystemServer コマンドレットを使用 します。

すべてのサイト システム サーバーを削除するには 、-ClearSiteSystemServer パラメーターを使用 します。

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

-RemoveSiteSystemServerName

境界グループから削除する 1 つ以上のサイト システム サーバーの名前を指定します。 すべてのサイト システム サーバーを削除するには 、-ClearSiteSystemServer パラメーターを使用 します。

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

-SubnetPeerDownloadOnly

境界グループ オプションを構成して、ピアのダウンロード中に同じサブネット内のピアのみを使用します。 この設定を有効にするには 、-AllowPeerDownload も有効にします。 詳細については、「ピア ダウンロードの 境界グループ オプション」を参照してください。

Type:	Boolean
Aliases:	PeerWithinSameSubnetOnly
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

関連リンク

• Get-CMBoundaryGroup
• New-CMBoundaryGroup
• Remove-CMBoundaryGroup
• Set-CMSecurityScope
• New-CMBoundary
• サイト境界と境界グループの定義