AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Get-EC2SecurityGroup-GroupId <String[]>-Filter <Filter[]>-GroupName <String[]>-MaxResult <Int32>-NextToken <String>-Select <String>-PassThru <SwitchParameter>-NoAutoIteration <SwitchParameter>-ClientConfig <AmazonEC2Config>
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
description
- The description of the security group.egress.ip-permission.cidr
- An IPv4 CIDR block for an outbound security group rule.egress.ip-permission.from-port
- For an outbound rule, the start of port range for the TCP and UDP protocols, or an ICMP type number.egress.ip-permission.group-id
- The ID of a security group that has been referenced in an outbound security group rule.egress.ip-permission.group-name
- The name of a security group that is referenced in an outbound security group rule.egress.ip-permission.ipv6-cidr
- An IPv6 CIDR block for an outbound security group rule.egress.ip-permission.prefix-list-id
- The ID of a prefix list to which a security group rule allows outbound access.egress.ip-permission.protocol
- The IP protocol for an outbound security group rule (tcp
| udp
| icmp
, a protocol number, or -1 for all protocols).egress.ip-permission.to-port
- For an outbound rule, the end of port range for the TCP and UDP protocols, or an ICMP code.egress.ip-permission.user-id
- The ID of an Amazon Web Services account that has been referenced in an outbound security group rule.group-id
- The ID of the security group. group-name
- The name of the security group.ip-permission.cidr
- An IPv4 CIDR block for an inbound security group rule.ip-permission.from-port
- For an inbound rule, the start of port range for the TCP and UDP protocols, or an ICMP type number.ip-permission.group-id
- The ID of a security group that has been referenced in an inbound security group rule.ip-permission.group-name
- The name of a security group that is referenced in an inbound security group rule.ip-permission.ipv6-cidr
- An IPv6 CIDR block for an inbound security group rule.ip-permission.prefix-list-id
- The ID of a prefix list from which a security group rule allows inbound access.ip-permission.protocol
- The IP protocol for an inbound security group rule (tcp
| udp
| icmp
, a protocol number, or -1 for all protocols).ip-permission.to-port
- For an inbound rule, the end of port range for the TCP and UDP protocols, or an ICMP code.ip-permission.user-id
- The ID of an Amazon Web Services account that has been referenced in an inbound security group rule.owner-id
- The Amazon Web Services account ID of the owner of the security group.tag
:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner
and the value TeamA
, specify tag:Owner
for the filter name and TeamA
for the filter value.tag-key
- The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.vpc-id
- The ID of the VPC specified when the security group was created.Required? | False |
Position? | 2 |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Filters |
Required? | False |
Position? | 1 |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Aliases | GroupIds |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | GroupNames |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | MaxItems, MaxResults |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | AK |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | AWSProfilesLocation, ProfilesLocation |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | StoredCredentials, AWSProfileName |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | RegionToCall |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | SK, SecretAccessKey |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | ST |
Get-EC2SecurityGroup -GroupId sg-12345678
Description : default VPC security group
GroupId : sg-12345678
GroupName : default
IpPermissions : {Amazon.EC2.Model.IpPermission}
IpPermissionsEgress : {Amazon.EC2.Model.IpPermission}
OwnerId : 123456789012
Tags : {}
VpcId : vpc-12345678This example describes the specified security group for a VPC. When working with security groups belonging to a VPC you must use the security group ID (-GroupId parameter), not name (-GroupName parameter), to reference the group.
Get-EC2SecurityGroup -GroupName my-security-group
Description : my security group
GroupId : sg-45678901
GroupName : my-security-group
IpPermissions : {Amazon.EC2.Model.IpPermission, Amazon.EC2.Model.IpPermission}
IpPermissionsEgress : {}
OwnerId : 123456789012
Tags : {}
VpcId :This example describes the specified security group for EC2-Classic. When working with security groups for EC2-Classic you may use either the group name (-GroupName parameter) or group ID (-GroupId parameter) to reference the security group.
Get-EC2SecurityGroup -Filter @{Name="vpc-id";Values="vpc-0fc1ff23456b789eb"}This example retrieves all the security groups for the vpc-0fc1ff23456b789eb
AWS Tools for PowerShell: 2.x.y.z