Get-EntraBetaApplicationProxyConnector
The Get-EntraBetaApplicationProxyConnector cmdlet a list of all connectors, or if specified, details of a specific connector.
Syntax
GetQuery (Default)
Get-EntraBetaApplicationProxyConnector
[-All]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
GetVague
Get-EntraBetaApplicationProxyConnector
[-SearchString <String>]
[-All]
[<CommonParameters>]
GetById
Get-EntraBetaApplicationProxyConnector
-OnPremisesPublishingProfileId <String>
[-All]
[<CommonParameters>]
Description
The Get-EntraBetaApplicationProxyConnector cmdlet retrieves the details for a given connector.
If no connectorId is specified, it retrieves all the connectors assigned to the tenant.
Examples
Example 1: Retrieve all connectors
Connect-Entra -Scopes 'Directory.ReadWrite.All'
Get-EntraBetaApplicationProxyConnector
Id DeletedDateTime
-- ---------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
This command Retrieve all connectors.
Example 2: Retrieve information for a specific connector
Connect-Entra -Scopes 'Directory.ReadWrite.All'
Get-EntraBetaApplicationProxyConnector -OnPremisesPublishingProfileId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
Id DeletedDateTime
-- ---------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
This example demonstrates how to Retrieve information for a specific connector.
OnPremisesPublishingProfileIdparameter specifies the connector ID.
Example 3: Retrieve information for a top one connector
Connect-Entra -Scopes 'Directory.ReadWrite.All'
Get-EntraBetaApplicationProxyConnector -Top 1
Id DeletedDateTime
-- ---------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
This example demonstrates how to Retrieve information for a top one connector. You can use -Limit as an alias for -Top.
Example 4: Retrieve information with SearchString parameter
Connect-Entra -Scopes 'Directory.ReadWrite.All'
Get-EntraBetaApplicationProxyConnector -SearchString 'Entra PowerShell AppProxy Connector'
Id DeletedDateTime
-- ---------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
This example demonstrates how to Retrieve information using SearchString.
Example 5: Retrieve information using machineName property
Connect-Entra -Scopes 'Directory.ReadWrite.All'
Get-EntraBetaApplicationProxyConnector -Filter "machineName eq 'AppProxy Machine'"
Id DeletedDateTime
-- ---------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
This example demonstrates how to Retrieve information using machineName property.
Parameters
-All
List all pages.
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| 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 |
-Filter
Specifies an OData v4.0 filter statement. This parameter controls which objects are returned. Details on querying with oData can be found here: https://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
GetQuery
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-OnPremisesPublishingProfileId
The ID of the specific connector. You can find this ID by running the command without this parameter to get the desired ID, or by going into the portal and viewing connector details.
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Id |
Parameter sets
GetById
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-SearchString
Specifies a search string.
Parameter properties
| Type: | System.String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
GetVague
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Top
Specifies the maximum number of records to return.
Parameter properties
| Type: | System.Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Limit |
Parameter sets
GetQuery
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| 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]]