Set-CMBoundary
サイト境界を構成します。
構文
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」を参照してください。