Edit

Share via

Get-EntraBetaPrivateAccessApplicationSegment

  • Reference
Module:
Microsoft.Entra.Beta

Retrieves a list of all application segments associated to a Private Access application, or if specified, details of a specific application segment.

Syntax

Get-EntraBetaPrivateAccessApplicationSegment
   -ApplicationId <String>
   [-ApplicationSegmentId <String>]
   [<CommonParameters>]

Description

The Get-EntraBetaPrivateAccessApplicationSegment cmdlet retrieves a list of all application segments associated to a Private Access application, or if specified, details of a specific application segment.

Examples

Example 1: Retrieve all application segments associated to an application

Connect-Entra -Scopes 'NetworkAccessPolicy.ReadWrite.All', 'Application.ReadWrite.All', 'NetworkAccess.ReadWrite.All'
$application = Get-EntraBetaApplication -Filter "displayName eq '<GlobalSecureAccess_Application_DisplayName>'"
Get-EntraBetaPrivateAccessApplicationSegment -ApplicationId $application.Id

destinationHost : 10.1.1.20
destinationType : ip
port            : 0
ports           : {22-22}
protocol        : tcp
id              : cccc2222-dd33-4444-55ee-666666ffffff

This command retrieves all application segments for an application.

Example 2: Retrieve a specific application segment associated to an application

Connect-Entra -Scopes 'NetworkAccessPolicy.ReadWrite.All', 'Application.ReadWrite.All', 'NetworkAccess.ReadWrite.All'
$application = Get-EntraBetaApplication -Filter "displayName eq '<GlobalSecureAccess_Application_DisplayName>'"
$applicationSegment = Get-EntraBetaPrivateAccessApplicationSegment -ApplicationId $application.Id | Where-Object {$_.destinationType -eq 'fqdn'}
Get-EntraBetaPrivateAccessApplicationSegment -ApplicationId $application.Id -ApplicationSegmentId $applicationSegment.Id

destinationHost : 10.1.1.20
destinationType : ip
port            : 0
ports           : {22-22}
protocol        : tcp
id              : cccc2222-dd33-4444-55ee-666666ffffff

This example demonstrates how to retrieve information for a specific application segment.

Parameters

-ApplicationId

The Object ID of a Private Access application object.

Type:System.String
Aliases:ObjectId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationSegmentId

Specifies a specific application segment to retrieve.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

System.Nullable`1[[System. Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]] System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Outputs

System.Object