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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternativeNames

Nomi alternativi per questa entità servizio

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppRoleAssignmentRequired

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Specifica il nome visualizzato.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorUrl

Specifica l'URL di errore.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Homepage

Specifica la home page.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyCredentials

Raccolta delle credenziali chiave associate all'entità servizio.

Type:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogoutUrl

Specifica l'URL di disconnessione.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordCredentials

Specifica le credenziali della password.

Type:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublisherName

Specifica il nome dell'autore.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SamlMetadataUrl

URL per i metadati SAML

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalNames

Specifica una matrice di nomi di 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 della risorsa per acquisire un token di accesso, ovvero l'URI restituito nell'attestazione.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

Tipo di entità servizio

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

Tag collegati a questa entità servizio.

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Note

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