Condividi tramite

New-AzureADServicePrincipal

  • Riferimento
Modulo:
AzureAD

Crea un'entità servizio.

Sintassi

New-AzureADServicePrincipal
   [-AccountEnabled <String>]
   [-AlternativeNames <System.Collections.Generic.List`1[System.String]>]
   -AppId <String>
   [-AppRoleAssignmentRequired <Boolean>]
   [-DisplayName <String>]
   [-ErrorUrl <String>]
   [-Homepage <String>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
   [-LogoutUrl <String>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
   [-PublisherName <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-SamlMetadataUrl <String>]
   [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
   [-ServicePrincipalType <String>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [<CommonParameters>]

Esempio

Esempio 1: Creare un'entità servizio

PS C:\>New-AzureADServicePrincipal -AccountEnabled $true -AppId $MyApp.AppId -AppRoleAssignmentRequired $true -DisplayName $App -Tags {WindowsAzureActiveDirectoryIntegratedApp}

Questo comando crea un'entità servizio. Il tag "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" viene usato per visualizzare questa entità servizio nell'elenco delle applicazioni integrate nel portale di amministrazione.

Parametri

-AccountEnabled

true se l'account dell'entità servizio è abilitato; in caso contrario, false.

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

-AlternativeNames

Nomi alternativi per questa entità servizio

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AppId

Identificatore univoco per l'applicazione associata (proprietà appId).

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

-AppRoleAssignmentRequired

Indica se è necessaria un'assegnazione di ruolo dell'applicazione.

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

-DisplayName

Specifica il nome visualizzato.

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

-ErrorUrl

Specifica l'URL di errore.

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

-Homepage

Specifica la home page.

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

-KeyCredentials

Raccolta delle credenziali chiave associate all'entità servizio.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LogoutUrl

Specifica l'URL di disconnessione.

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

-PasswordCredentials

Specifica le credenziali della password.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PublisherName

Specifica il nome dell'autore.

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

-ReplyUrls

URL a cui vengono inviati i token utente per accedere con l'applicazione associata o URI di reindirizzamento a cui vengono inviati i token di accesso e i codici di autorizzazione OAuth 2.0 per l'applicazione associata.

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SamlMetadataUrl

URL per i metadati SAML

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

-ServicePrincipalNames

Specifica una matrice di nomi dell'entità servizio. In base all'insieme identifierURIs, oltre alla proprietà appId dell'applicazione, questi URI vengono usati per fare riferimento all'entità servizio di un'applicazione. Un client userà questi elementi per:

  • popolare requiredResourceAccess, tramite "Autorizzazioni per altre applicazioni" nel portale di Azure classico. - specificare un URI di risorsa per acquisire un token di accesso, ovvero l'URI restituito nell'attestazione.
Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServicePrincipalType

Tipo THe dell'entità servizio

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

-Tags

Tag collegati a questa entità servizio.

Si noti che se si intende visualizzare questa entità servizio nell'elenco Tutte le applicazioni nel portale di amministrazione, è necessario impostare questo valore su {WindowsAzureActiveDirectoryIntegratedApp}

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Note

Vedere la guida alla migrazione per New-AzureADServicePrincipal in Microsoft Graph PowerShell.