New-AEDeviceTag

NAME New-AEDeviceTag



SYNOPSIS

Adds a single device tag to the list of device tags





SYNTAX

New-AEDeviceTag [-AEServer] <String> [-DeviceID] <String> [-Category] <String> [-Name] <String> [[-Index] <Int32>]

[[-Value] <String>] [[-CreatedBy] <String>] [<CommonParameters>]





DESCRIPTION

The New-AEDeviceTag Cmdlet adds a single device tag to the list of device tags. Device tags are identified by

category, name and index. They do not have an explicit id. If tag with the same category, name and index already

exists, the value and the modified date get updated.





PARAMETERS

-AEServer <String>

Specified the URL of the 1E ActiveEfficiency server



Required? true

Position? 1

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DeviceID <String>

Specifies the AE DeviceID



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Category <String>

Specifies the category (namespace) for the tag. The category and name uniquely identify the resource. Category

is mandatory. It must not be null, empty or only whitespace.



Required? true

Position? 3

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Specifies the tag name. Name is mandatory. It must not be null, empty or only whitespace.



Required? true

Position? 4

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Index <Int32>

Specifies the tag index. Will be 0 on default.



Required? false

Position? 5

Default value 0

Accept pipeline input? False

Accept wildcard characters? false



-Value <String>

Specifies the actual value of the tag. TODO: Implement handling of different types



Required? false

Position? 6

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-CreatedBy <String>

Specifies the name of the client creating the tag entry. Currently not mandatory.



Required? false

Position? 7

Default value 1E Nomad

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



NOTES









-------------------------- EXAMPLE 1 --------------------------











RELATED LINKS