Set-CMBoundaryGroup
境界グループのプロパティを変更します。
構文
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 コマンドレット」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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 コマンドレットを使用します。
| 型: | IResultObject[] |
| Aliases: | AddSiteSystemServers |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AddSiteSystemServerName
この境界グループに追加するサイト システム サーバーの完全修飾ドメイン名を指定します。 境界グループ上のクライアントは、ポリシーとコンテンツにこれらのサーバーを使用します。 管理ポイント、配布ポイント、状態移行ポイント、ソフトウェア更新ポイント、クラウド管理ゲートウェイを追加できます。
重要
このパラメーターには、サイト サーバーの完全修飾ドメイン名が必要です。
| 型: | String[] |
| Aliases: | AddSiteSystemServerNames |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AllowPeerDownload
この境界グループでピアのダウンロードを許可するように境界グループ オプションを構成します。 詳細については、「 ピアダウンロードの境界グループ オプション」を参照してください。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ClearSiteSystemServer
このパラメーターを追加して、参照されているすべてのサイト システム サーバーを境界グループから削除します。
| 型: | SwitchParameter |
| Aliases: | ClearSiteSystemServers |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultSiteCode
割り当てられたサイトとして設定するサイト コードを指定し、サイト割り当ての境界グループを有効にします。
境界グループのサイト割り当てを無効にするには、この値を $null に設定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
この境界グループの説明 (省略可能) を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Id
構成する境界グループの ID を指定します。 この ID は、SMS_BoundaryGroup オブジェクトの GroupID プロパティです。 たとえば、「 33 」のように入力します。
| 型: | String |
| Aliases: | GroupId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
構成する境界グループのオブジェクトを指定します。 境界グループ オブジェクトを取得するには、 Get-CMBoundaryGroup コマンドレットを使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
構成する境界グループの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NewName
境界グループの名前を変更するには、このパラメーターを使用します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
作業中のアイテムを表す オブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PreferCloudDPOverDP
オンプレミスのソースよりもクラウドベースのソースを優先するように境界グループ オプションを構成します。 詳細については、「 ピアダウンロードの境界グループ オプション」を参照してください。
| 型: | Boolean |
| Aliases: | PreferCloudDistributionPointOverDistributionPoint |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PreferDPOverPeer
同じサブネット内のピアよりも配布ポイントを優先するように、境界グループ オプションを構成します。 この設定を有効にするには、 -AllowPeerDownload も有効にします。 詳細については、「 ピアダウンロードの境界グループ オプション」を参照してください。
| 型: | Boolean |
| Aliases: | PreferDistributionPointOverPeerInSubnet |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveSiteSystemServer
境界グループから削除するサイト システム サーバー オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSiteSystemServer コマンドレットを使用します。
すべてのサイト システム サーバーを削除するには、 -ClearSiteSystemServer パラメーターを使用します。
| 型: | IResultObject[] |
| Aliases: | RemoveSiteSystemServers |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveSiteSystemServerName
境界グループから削除する 1 つ以上のサイト システム サーバーの名前を指定します。 すべてのサイト システム サーバーを削除するには、 -ClearSiteSystemServer パラメーターを使用します。
| 型: | String[] |
| Aliases: | RemoveSiteSystemServerNames |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SubnetPeerDownloadOnly
ピアのダウンロード中に同じサブネット内のピアのみを使用するように境界グループ オプションを構成します。 この設定を有効にするには、 -AllowPeerDownload も有効にします。 詳細については、「 ピアダウンロードの境界グループ オプション」を参照してください。
| 型: | Boolean |
| Aliases: | PeerWithinSameSubnetOnly |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject