Get-NsxSecurityGroupEffectiveVirtualMachine

NAME Get-NsxSecurityGroupEffectiveVirtualMachine



SYNOPSIS

Determines the effective VM membership of a security group.





SYNTAX

Get-NsxSecurityGroupEffectiveVirtualMachine -SecurityGroup <XmlElement> [-Connection <PSObject>]

[<CommonParameters>]



Get-NsxSecurityGroupEffectiveVirtualMachine [-SecurityGroupId] <String> [-Connection <PSObject>]

[<CommonParameters>]





DESCRIPTION

An NSX SecurityGroup can contain members (VMs, IP Addresses, MAC Addresses

or interfaces) by virtue of direct, or indirect membership (nested security

groups), and either by static or dynamic inclusion.



In addition, direct or indirect exclusions can also

modify membership.



This cmdlet uses the NSX 'Translation APIs' to determine the

'Effective VM Membership' of a given security group. The membership output

by this cmdlet is determined by NSX itself.





PARAMETERS

-SecurityGroup <XmlElement>



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-SecurityGroupId <String>



Required? true

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Connection <PSObject>

PowerNSX Connection object



Required? false

Position? named

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-NsxSecurityGroup testSG | Get-NsxSecurityGroupEffectiveVirtualMachine



VmName VmId

------ ----

Web01 vm-1270



Determine the effective VM membership of testSG









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



PS C:\\>Get-NsxSecurityGroupEffectiveVirtualMachine -SecurityGroupId securitygroup-1234



VmName VmId

------ ----

Web01 vm-1270



Determine the effective VM membership of a security group by object id.











RELATED LINKS