< Back
Remove-NsxMacSet
Post
NAME Remove-NsxMacSet
SYNOPSIS
Removes the specified NSX MacSet.
SYNTAX
Remove-NsxMacSet [-MacSet] <XmlElement> [-confirm] [-force] [[-Connection] <PSObject>] [<CommonParameters>]
DESCRIPTION
An NSX MacSet is a grouping construct that allows for grouping of
Mac Addresses in a sigle container that can
be used either in DFW Firewall Rules or as members of a security
group.
This cmdlet removes the specified MAC Set. 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
-MacSet <XmlElement>
Macset as retrieved by get-nsxmacset to remove
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false
-confirm [<SwitchParameter>]
Set to false to disable prompt on deletion
Required? false
Position? named
Default value True
Accept pipeline input? false
Accept wildcard characters? false
-force [<SwitchParameter>]
Enable force to remove objects in use, or set to readonly (system)
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:\\>This will remove a MAC Set by name.
Get-NsxMacSet MAC_SET_TEST | Remove-NsxMacSet
-confirm:$false can be used to avoid being prompted.
RELATED LINKS
SYNOPSIS
Removes the specified NSX MacSet.
SYNTAX
Remove-NsxMacSet [-MacSet] <XmlElement> [-confirm] [-force] [[-Connection] <PSObject>] [<CommonParameters>]
DESCRIPTION
An NSX MacSet is a grouping construct that allows for grouping of
Mac Addresses in a sigle container that can
be used either in DFW Firewall Rules or as members of a security
group.
This cmdlet removes the specified MAC Set. 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
-MacSet <XmlElement>
Macset as retrieved by get-nsxmacset to remove
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false
-confirm [<SwitchParameter>]
Set to false to disable prompt on deletion
Required? false
Position? named
Default value True
Accept pipeline input? false
Accept wildcard characters? false
-force [<SwitchParameter>]
Enable force to remove objects in use, or set to readonly (system)
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:\\>This will remove a MAC Set by name.
Get-NsxMacSet MAC_SET_TEST | Remove-NsxMacSet
-confirm:$false can be used to avoid being prompted.
RELATED LINKS