< Back
New-NsxMacSet
Post
NAME New-NsxMacSet
SYNOPSIS
Creates a new NSX MACSet.
SYNTAX
New-NsxMacSet [-Name] <String> [[-Description] <String>] [[-MacAddresses] <String>] [[-scopeId] <String>]
[-Universal] [-EnableInheritance] [-ReturnObjectIdOnly] [[-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 creates a new MAC Set with the specified parameters.
MacAddresses is a string that can contain 1 or more MAC Addresses the following
separated by commas
Mac address: (eg, 00:00:00:00:00:00)
PARAMETERS
-Name <String>
Name of the MacSet
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Description <String>
Description of the MacSet
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-MacAddresses <String>
Single string accepting comma separated Mac Addresses
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-scopeId <String>
Scope of object. For universal object creation, use the -Universal switch.
Required? false
Position? 4
Default value globalroot-0
Accept pipeline input? false
Accept wildcard characters? false
-Universal [<SwitchParameter>]
Create the MacSet as Universal object.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-EnableInheritance [<SwitchParameter>]
Create the MacSet with the inheritance set. Allows the MacSet to be used at a lower scope.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-ReturnObjectIdOnly [<SwitchParameter>]
Return the objectid as a string rather than the whole XML object.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Connection <PSObject>
PowerNSX Connection object
Required? false
Position? 5
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:\\>new-nsxmacset -name MAC_SET_TEST -Description "A sample MAC" -MacAddresses "BE:EF:CA:FE:DE:AD"
Creates a MAC Set with the MAC address BEEF:CAFE:DEAD
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>new-nsxmacset -name MAC_SET_TEST -Description "A sample MAC" -MacAddresses "BE:EF:CA:FE:DE:AD" -Universal
Creates a MAC Set in the universal scope
RELATED LINKS
SYNOPSIS
Creates a new NSX MACSet.
SYNTAX
New-NsxMacSet [-Name] <String> [[-Description] <String>] [[-MacAddresses] <String>] [[-scopeId] <String>]
[-Universal] [-EnableInheritance] [-ReturnObjectIdOnly] [[-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 creates a new MAC Set with the specified parameters.
MacAddresses is a string that can contain 1 or more MAC Addresses the following
separated by commas
Mac address: (eg, 00:00:00:00:00:00)
PARAMETERS
-Name <String>
Name of the MacSet
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Description <String>
Description of the MacSet
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-MacAddresses <String>
Single string accepting comma separated Mac Addresses
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-scopeId <String>
Scope of object. For universal object creation, use the -Universal switch.
Required? false
Position? 4
Default value globalroot-0
Accept pipeline input? false
Accept wildcard characters? false
-Universal [<SwitchParameter>]
Create the MacSet as Universal object.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-EnableInheritance [<SwitchParameter>]
Create the MacSet with the inheritance set. Allows the MacSet to be used at a lower scope.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-ReturnObjectIdOnly [<SwitchParameter>]
Return the objectid as a string rather than the whole XML object.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-Connection <PSObject>
PowerNSX Connection object
Required? false
Position? 5
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:\\>new-nsxmacset -name MAC_SET_TEST -Description "A sample MAC" -MacAddresses "BE:EF:CA:FE:DE:AD"
Creates a MAC Set with the MAC address BEEF:CAFE:DEAD
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>new-nsxmacset -name MAC_SET_TEST -Description "A sample MAC" -MacAddresses "BE:EF:CA:FE:DE:AD" -Universal
Creates a MAC Set in the universal scope
RELATED LINKS