< Back

Get-AzureRmADServicePrincipal

Tue Jan 29, 2019 10:05 pm

NAME Get-AzureRmADServicePrincipal



SYNOPSIS

Filters active directory service principals.





SYNTAX

Get-AzureRmADServicePrincipal [-DefaultProfile <IAzureContextContainer>] -ObjectId <Guid> [<CommonParameters>]



Get-AzureRmADServicePrincipal [-DefaultProfile <IAzureContextContainer>] -SearchString <String> [<CommonParameters>]



Get-AzureRmADServicePrincipal [-DefaultProfile <IAzureContextContainer>] -ServicePrincipalName <String> [<CommonParameters>]





DESCRIPTION

Filters active directory service principals.





PARAMETERS

-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ObjectId <Guid>

Object id of the service principal.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-SearchString <String>

Fetches all service principals that have the display name starting with this value.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ServicePrincipalName <String>

SPN of the service.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

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 (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

This cmdlet does not accept any input.





OUTPUTS

System.Collections.Generic.List`1[Microsoft.Azure.Graph.RBAC.Version1_6.ActiveDirectory.PSADServicePrincipal]







NOTES









Filters service principals using SPN



PS C:\\> Get-AzureRmADServicePrincipal -SPN 36f81fc3-b00f-48cd-8218-3879f51ff39f



Gets service principals with 36f81fc3-b00f-48cd-8218-3879f51ff39f SPN.





Filters service principals using Search String



PS C:\\> Get-AzureRmADServicePrincipal -SearchString "Web"



Filters all ad service principals that have display name starting with "Web".





List AD service principals



PS C:\\> Get-AzureRmADServicePrincipal



Gets all AD service principals.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... eprincipal

New-AzureRmADServicePrincipal

Set-AzureRmADServicePrincipal

Remove-AzureRmADServicePrincipal

Get-AzureRmADApplication

Get-AzureRmADSpCredential