New-EntraBetaPrivateAccessApplication
Creates a Private Access application and assigns a connector group to it.
Syntax
Default (Default)
New-EntraBetaPrivateAccessApplication
-ApplicationName <String>
[-ConnectorGroupId <String>]
[<CommonParameters>]
Description
The New-EntraBetaPrivateAccessApplication cmdlet creates a Private Access application and assigns a connector group to it.
Examples
Example 1: Create a new Private Access app and assign the default connector group
Connect-Entra -Scopes 'NetworkAccessPolicy.ReadWrite.All', 'Application.ReadWrite.All', 'NetworkAccess.ReadWrite.All'
New-EntraBetaPrivateAccessApplication -ApplicationName 'Contoso GSA Application'
This example shows how to create a new Private Access application named Contoso GSA Application and assign it to the default connector group.
Example 2: Create a new Private Access app and assign a specific connector group
Connect-Entra -Scopes 'NetworkAccessPolicy.ReadWrite.All', 'Application.ReadWrite.All', 'NetworkAccess.ReadWrite.All'
$connectorGroup = Get-EntraBetaApplicationProxyConnectorGroup -Filter "Name eq 'Contoso GSA Group'"
New-EntraBetaPrivateAccessApplication -ApplicationName 'Contoso GSA Application' -ConnectorGroupId $connectorGroup.Id
This example shows how to create a new Private Access application named Contoso GSA Application and assign it to a specific connector group.
Parameters
-ApplicationName
The name of the new Private Access application.
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ConnectorGroupId
Specifies a connector group to assign to the application. Use Get-EntraBetaApplicationProxyConnectorGroup to retrieve connector details or New-EntraBetaApplicationProxyConnectorGroup to create a new group.
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
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]]