Condividi tramite


Get-AzureRmADServicePrincipal

Filtra le entità servizio active directory.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Get-AzureRmADServicePrincipal
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayNameBeginsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ServicePrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Descrizione

Filtra le entità servizio active directory.

Esempio

Esempio 1 - Elencare le entità servizio di Active Directory

PS C:\> Get-AzureRmADServicePrincipal

Elenca tutte le entità servizio di Active Directory in un tenant.

Esempio 2- Elencare le entità servizio di Active Directory usando il paging

PS C:\> Get-AzureRmADServicePrincipal -First 100

Elenca le prime 100 entità servizio di Active Directory in un tenant.

Esempio 3 - Elencare le entità servizio in base al nome SPN

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

Elenca le entità servizio con il nome SPN '36f81fc3-b00f-48cd-8218-3879f51ff39f'.

Esempio 4 - Elencare le entità servizio in base alla stringa di ricerca

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

Elenca tutte le entità servizio di Active Directory il cui nome visualizzato inizia con "Web".

Esempio 5 - Elencare le entità servizio tramite pipe

PS C:\> Get-AzureRmADApplication -ObjectId 39e64ec6-569b-4030-8e1c-c3c519a05d69 | Get-AzureRmADServicePrincipal

Ottiene l'applicazione AD con ID oggetto '39e64ec6-569b-4030-8e1c-c3c519a05d69' e lo invia tramite pipe al cmdlet Get-AzureRmADServicePrincipal per elencare tutte le entità servizio per l'applicazione.

Parametri

-ApplicationId

ID applicazione dell'entità servizio.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ApplicationObject

Oggetto applicazione di cui viene recuperata l'entità servizio.

Tipo:PSADApplication
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

Nome visualizzato dell'entità servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DisplayNameBeginsWith

Stringa di ricerca dell'entità servizio.

Tipo:String
Alias:SearchString
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-First

Numero massimo di oggetti da restituire.

Tipo:UInt64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeTotalCount

Segnala il numero di oggetti nel set di dati. Attualmente, questo parametro non esegue alcuna operazione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ObjectId

ID oggetto dell'entità servizio.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServicePrincipalName

NOME SPN del servizio.

Tipo:String
Alias:SPN
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Skip

Ignora i primi N oggetti e quindi ottiene gli oggetti rimanenti.

Tipo:UInt64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Guid

PSADApplication

Parametri: ApplicationObject (ByValue)

Output

PSADServicePrincipal