Compartir a través de

New-AzureADServicePrincipal

Módulo:
AzureAD Module

Crea una entidad de servicio.

Sintaxis

Default (Es el valor predeterminado). 

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>]

Ejemplos

Ejemplo 1: Creación de una entidad de servicio

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

Este comando crea una entidad de servicio. La etiqueta "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" se usa para que esta entidad de servicio aparezca en la lista de aplicaciones integradas en el Portal de administración.

Parámetros

-AccountEnabled

es true si la cuenta de la entidad de servicio está habilitada; de lo contrario, es false.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AlternativeNames

Los nombres alternativos de esta entidad de servicio

Propiedades del parámetro

Tipo:

List<T>[String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AppId

Identificador único de la aplicación asociada (su propiedad appId).

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AppRoleAssignmentRequired

Indica si se requiere una asignación de roles de aplicación.

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayName

Especifica el nombre para mostrar.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ErrorUrl

Especifica la URL de error.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Homepage

Especifica la página de inicio.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-KeyCredentials

El conjunto de credenciales clave asociadas con la entidad de servicio.

Propiedades del parámetro

Tipo:

List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-LogoutUrl

Especifica la dirección URL de cierre de sesión.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PasswordCredentials

Especifica las credenciales de contraseña.

Propiedades del parámetro

Tipo:

List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PublisherName

Especifica el nombre del publicador.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ReplyUrls

Las direcciones URL a las que se envían tokens de usuario para iniciar sesión con la aplicación asociada, o los URI de redireccionamiento a los que se envían los códigos de autorización y los tokens de acceso de OAuth 2.0 para la aplicación asociada.

Propiedades del parámetro

Tipo:

List<T>[String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SamlMetadataUrl

La URL de los metadatos SAML

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServicePrincipalNames

Especifica una matriz de nombres de entidad de seguridad de servicio. En función de la colección identifierURIs, más la propiedad appId de la aplicación, estos URI se usan para hacer referencia a la entidad de servicio de una aplicación. Un cliente los usará para:

  • rellene requiredResourceAccess a través de "Permisos para otras aplicaciones" en el Portal de Azure clásico. - especificar un URI de recurso para adquirir un token de acceso, que es el URI devuelto en la notificación.

Propiedades del parámetro

Tipo:

List<T>[String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServicePrincipalType

El tipo de entidad de servicio

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Tags

Etiquetas vinculadas a esta entidad de servicio.

Tenga en cuenta que si desea que esta entidad de servicio aparezca en la lista Todas las aplicaciones del portal de administración, debe establecer este valor en {WindowsAzureActiveDirectoryIntegratedApp}

Propiedades del parámetro

Tipo:

List<T>[String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Notas

Consulte la guía de migración de New-AzureADServicePrincipal a Microsoft Graph PowerShell.