Add-IpamCustomValue

Add-IpamCustomValue

Adds a value to a custom field in IPAM.

構文

Parameter Set: AddCustomValue2
Add-IpamCustomValue [-Name] <String> [-Value] <String> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Add-IpamCustomValue cmdlet adds a value to a custom field in IP Address Management (IPAM). You can add a value to a built-in field or user-defined custom field.

パラメーター

-AsJob

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

エイリアス

Session

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Name<String>

Specifies the name of a custom field. The cmdlet adds the value that you specify for the Value parameter to the custom field. You can specify the localized server name or the non-localized name of a built-in, multivalued custom field.

エイリアス

なし

必須?

true

位置は?

2

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Value<String>

Specifies a value to add to the custom field.

エイリアス

なし

必須?

true

位置は?

3

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

  • None

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

  • Microsoft.Windows.Ipam.Commands.IpamCustomValue

    This object contains an IPAM custom value.

Example 1: Add a custom value

This command adds the custom value DivMain01 to the user defined custom field named Divisions.

PS C:\> Add-IpamCustomValue -Name "Divisions" -Value "DivMain01"

Example 2: Add a custom value to a user defined custom field

This command adds the custom value DivMain01 to the user defined custom field named Divisions. The command includes the PassThru parameter, so it displays results to the console.

PS C:\> Add-IpamCustomValue -Name "Divisions" -Value "DivMain01" -PassThru

Example 3: Add a custom value to a built-in custom field

This command adds the custom value vmm1.contoso.com to the built-in custom field named ServiceInstance. The command includes the PassThru parameter, so it displays results to the console.

PS C:\> Add-IpamCustomValue -Name "ServiceInstance" -Value "vmm1.contoso.com" -PassThru

関連トピック

Remove-IpamCustomValue

Rename-IpamCustomValue

Add-IpamCustomField

Get-IpamCustomField