New-vRNIApplicationTier

NAME New-vRNIApplicationTier



SYNOPSIS

Create a Tier in an Application container in vRealize Network Insight.





SYNTAX

New-vRNIApplicationTier -Application <PSObject> -Name <String> [-Filters <String[]>] [-Connection <PSObject>]

[<CommonParameters>]



New-vRNIApplicationTier -Application <PSObject> -Name <String> [-VMFilters <String[]>] [-Connection <PSObject>]

[<CommonParameters>]



New-vRNIApplicationTier -Application <PSObject> -Name <String> [-IPFilters <String[]>] [-Connection <PSObject>]

[<CommonParameters>]





DESCRIPTION

Within vRNI there are applications, which can be viewed as groups of VMs.

These groups can be used to group the VMs of a certain application together,

and filter on searches within vRNI. For instance, you can generate recommended

firewall rules based on an application group.





PARAMETERS

-Application <PSObject>

Application object, gotten from Get-vRNIApplication



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Name <String>

The name of the new tier



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Filters <String[]>

The filters within an application tier determine what VMs will be placed in that

application. Currently, only these options are supported:



Single VM: "name = '3TA-App01'"

Multiple VMs: "name = '3TA-App01' or name = '3TA-App02'"

VMs with a NSX Security Tag: "security_groups.entity_id = '18230:82:604573173'"



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-VMFilters <String[]>

The VM filters in the new tier



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-IPFilters <String[]>

The IP set filters in the new tier



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Connection <PSObject>

vRNI Connection object



Required? false

Position? named

Default value $defaultvRNIConnection

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-vRNIApplication My3TierApp | New-vRNIApplicationTier -Name web-tier -VMFilters ("name = '3TA-Web01' or

name = '3TA-Web02'")



Create a new tier in the application 'My3TierApp' called 'web-tier' and assign the VMs named '3TA-Web01' and

'3TA-Web02' to this tier.









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



PS C:\\>$security_group_id = (Get-vRNISecurityGroup SG-3Tier-App).entity_id



PS C:\\> Get-vRNIApplication My3TierApp | New-vRNIApplicationTier -Name app-tier -VMFilters ("name = '3TA-App01'",

"security_groups.entity_id = '$security_group_id'")

Create a new tier in the application 'My3TierApp' called 'web-tier' and assign the

VMs named '3TA-Web01' and '3TA-Web02' to this tier.









-------------------------- EXAMPLE 3 --------------------------



PS C:\\>Get-vRNIApplication IP-Network | New-vRNIApplicationTier -Name IP-Set-1 -IPFilters 100.194.0.0/24,

192.168.1.1, 192.168.10.0/27



This retrieves the existing application called 'IP-Network' and creates a new tier

inside it called 'IP-Set-1' with a /24 subnet, a single host and a /27 subnet.









-------------------------- EXAMPLE 4 --------------------------



PS C:\\>Get-vRNIApplication IP-Network | New-vRNIApplicationTier -Name IP-Host-2 -IPFilters 172.16.0.10



This retrieves the existing application called 'IP-Network' and creates a new tier

inside it called 'IP-Host-2' with a single host on the IP 172.16.0.10.











RELATED LINKS