New-CMBoundary
サイト境界を作成します。
構文
New-CMBoundary
[-Name <String>]
-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: IP サブネット サイトの境界を作成する
このコマンドは、 IPSubNetBoundary01 の名前と 172.16.50.0/24 の値を持つ新しい IP サブネット サイト境界を作成します。
New-CMBoundary -DisplayName "IPSubNetBoundary01" -BoundaryType IPSubNet -Value "172.16.50.0/24"
例 2: Active Directory サイト境界を作成する
このコマンドは、 ADSiteBoundary01 の名前と Default-First-Site-Name の値を持つ新しい Active Directory サイト境界を作成します。
New-CMBoundary -DisplayName "ADSiteBoundary01" -BoundaryType ADSite -Value "Default-First-Site-Name"
例 3: IPv6 プレフィックス サイト境界を作成する
このコマンドは、 IPv6PrefixBoundary01 の名前と FE80::/64 の値を持つ新しい IPv6 プレフィックス サイト境界を作成します。
New-CMBoundary -DisplayName "IPv6PrefixBoundary01" -BoundaryType IPv6Prefix -Value "FE80::/64"
例 4: IP 範囲サイト境界を作成する
このコマンドは、 IPRangeBoundary01 という名前と値 が 10.255.255.0-10.255.255.255 の新しい IP 範囲サイト境界を作成します。
New-CMBoundary -DisplayName "IPRangeBoundary01" -BoundaryType IPRange -Value "10.255.255.0-10.255.255.255"
例 5: VPN サイトの境界を作成する
このコマンドは、 VPN-CONTOSO1-Name という名前と Name:CONTOSO1 の値を持つ新しい VPN サイト境界を作成します。
New-CMBoundary -DisplayName "VPN-CONTOSO1-Name" -BoundaryType VPN -Value "Name:CONTOSO1"
パラメーター
-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 |
-Name
新しい境界の名前を指定します。
型: | String |
Aliases: | DisplayName |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Type
境界の種類を指定します。
型: | BoundaryTypes |
Aliases: | BoundaryType |
指定可能な値: | IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Value
境界を定義するデータを指定します。 たとえば、Active Directory サイトの値を Default-First-Site-Name
できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ValueStartsWith
文字列全体ではなく、接続名または説明の先頭と一致するように、このパラメーターを $true
に設定します。 詳細については、「 ネットワークの場所を境界として定義する」を参照してください。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_Boundary」を参照してください。