Set-CMBoundary

  • リファレンス
モジュール:
ConfigurationManager

サイト境界を構成します。

構文

Set-CMBoundary
   -InputObject <IResultObject>
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBoundary
   -Id <String>
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBoundary
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   -Type <BoundaryTypes>
   -Value <String>
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

サイト境界を構成するには、このコマンドレットを使用します。 境界は、管理できる 1 つ以上のデバイスを含むネットワークの場所です。 境界には、IP サブネット、Active Directory サイト名、IPv6 プレフィックス、IP アドレス範囲、または VPN を指定できます。 詳細については、「 サイトの境界と境界グループを定義する」を参照してください。

注:

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

例

例 1: 境界の名前を変更する

このコマンドは、境界名を Default-ADSite から ADSiteBoundary01 に変更します。

Set-CMBoundary -Name "Default-ADSite" -NewName "ADSiteBoundary01"

例 2: InputObject を使用して境界の値を変更する

この例では、最初のコマンドは、16777217の ID を持つ境界を取得し、それを入力オブジェクト $BoundaryObjに挿入します。

2 番目のコマンドは、入力オブジェクト $BoundaryObjを使用して境界を識別し、その値を IPSubnet17 に変更します。

$BoundaryObj = Get-CMBoundary -Id "16777217"
Set-CMBoundary -InputObject $BoundaryObj -Value "IPSubnet17"

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

変更する境界識別子 (ID) を指定します。 この値は整数です (たとえば、 26)。

型:String
Aliases:BoundaryId
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

変更する境界オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMBoundary コマンドレットを 使用します。

型:IResultObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-NewName

境界の新しい名前を指定します。

型:String
Aliases:DisplayName, Name
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NewType

境界の種類を指定します。

型:BoundaryTypes
Aliases:NewBoundaryType
指定可能な値:IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NewValue

境界を定義するデータを指定します。 たとえば、Active Directory サイトの値を Default-First-Site-Nameできます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Type

境界の種類を指定します。

型:BoundaryTypes
Aliases:BoundaryType
指定可能な値:IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Value

境界を記述するデータを指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ValueStartsWith

文字列全体ではなく、接続名または説明の先頭と一致するように、このパラメーターを $true に設定します。 詳細については、「 ネットワークの場所を境界として定義する」を参照してください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_Boundary」を参照してください。