PowerCLI Reference

Set-CustomAttribute

Synopsis

This cmdlet renames a custom attribute.

Syntax

Set-CustomAttribute [-CustomAttribute] <CustomAttribute[]> [-Name] <String> [-Server <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-CustomAttribute
New-CustomAttribute
Remove-CustomAttribute
Get-Annotation
Set-Annotation

Detailed Description

This cmdlet renames a custom attribute.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameStringSpecifies a new name for the custom attribute.truefalse
CustomAttributeCustomAttribute[]Specifies the custom attribute you want to rename.truetrue (ByValue)
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falsefalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

Zero or more modified CustomAttribute objects

Notes

Examples

-------------- Example 1 --------------

Set-CustomAttribute -Name CreationDetails -CustomAttribute CreationDate

Renames a custom attribute from CreationDate to CreationDetails.

-------------- Example 2 --------------

Get-CustomAttribute -Name CreationDate -Server server1, server2 | Set-CustomAttribute -Name CreationDetails

Renames the custom attributes retrieved from the specified vSphere servers from CreationDate to CreationDetails.


Copyright © VMware, Inc. All rights reserved.