< Back

Remove-NsxSecurityTagAssignment

Sat Jan 18, 2020 9:25 pm

NAME Remove-NsxSecurityTagAssignment



SYNOPSIS

This cmdlet is used to remove NSX Security Tags assigned to a virtual machine





SYNTAX

Remove-NsxSecurityTagAssignment [-TagAssignment] <PSObject> [-Confirm] [[-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 assigns is used to remove NSX Security Tags assigned to a virtual machine





PARAMETERS

-TagAssignment <PSObject>



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



-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 ST-WEB-DMZ | Get-NsxSecurityTagAssignment | Remove-NsxSecurityTagAssignment



Gets all assignment of Security Tag ST-WEB-DMZ and removes its assignment from all VMs with confirmation.









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Get-VM Web01 | Get-NsxSecurityTagAssignment | Remove-NsxSecurityTagAssignment



Removes all security tags assigned to Web01 virtual machine.











RELATED LINKS