Remove-NsxSecurityTag

NAME Remove-NsxSecurityTag



SYNOPSIS

Removes the specified NSX Security Tag.





SYNTAX

Remove-NsxSecurityTag [-SecurityTag] <XmlElement> [-Confirm] [-force] [[-Connection] <PSObject>]

[<CommonParameters>]





DESCRIPTION

A NSX Security Tag is a arbitrary string. It is used in other functions of

NSX such as Security Groups match criteria. Security Tags are applied to a

Virtual Machine.



This cmdlet removes the specified NSX Security Tag



If the object is currently in use the api will return an error. Use -force

to override but be aware that the firewall rulebase will become invalid and

will need to be corrected before publish operations will succeed again.





PARAMETERS

-SecurityTag <XmlElement>



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompt for confirmation. Specify as -confirm:$false to disable confirmation prompt



Required? false

Position? named

Default value True

Accept pipeline input? false

Accept wildcard characters? false



-force [<SwitchParameter>]



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Connection <PSObject>

PowerNSX Connection object



Required? false

Position? 2

Default value $defaultNSXConnection

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



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



PS C:\\>Get-NsxSecurityTag TestSecurityTag | Remove-NsxSecurityTag















RELATED LINKS