Rename-IpamCustomValue

Rename-IpamCustomValue

Changes a value for a custom field.

Syntax

Parameter Set: RenameCustomValue1
Rename-IpamCustomValue [-Name] <String> [-Value] <String> [-NewValue] <String> [-AsJob] [-CimSession <CimSession[]> ] [-Force] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detaillierte Beschreibung

The Rename-IpamCustomValue cmdlet changes a value for a multivalued custom field. The cmdlet changes only the custom value. Associations between the custom field and other custom fields and assignments to other IPAM objects remain valid. You cannot change built-in values of built-in custom fields. The cmdlet results in an error if the value that you specify does not exist for the custom field that you specify.

Parameter

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-Force

Erzwingt, dass der Befehl ohne Benutzerbestätigung ausgeführt wird.

-Name<String>

Specifies the name of a custom field. The cmdlet changes the value from the custom field that you specify for the Value parameter.

-NewValue<String>

Specifies a value to replace the custom field value that you specify for the Value parameter.

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

-Value<String>

Specifies a custom value. The cmdlet changes this value to the value that you specify for the NewValue parameter.

-Confirm

Sie werden vor dem Ausführen des Cmdlets zur Bestätigung aufgefordert.

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• IpamCustomField

  Represents a custom metadata field in IPAM Server.

Beispiele

Example 1: Change a value for a custom field

This command changes the value from NorthB3 to MainB3 for the custom field named Building.

PS C:\> Rename-IpamCustomValue -Name "Building" -Value "NorthB3" -NewValue "MainB3" -PassThru

Verwandte Themen

Add-IpamCustomValue

Remove-IpamCustomValue