New-MsolServicePrincipal

Sintaxis

New-MsolServicePrincipal
   [-ServicePrincipalNames <String[]>]
   [-AppPrincipalId <Guid>]
   -DisplayName <String>
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-Type <ServicePrincipalCredentialType>]
   [-Value <String>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-Usage <ServicePrincipalCredentialUsage>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

El cmdlet New-MsolServicePrincipal crea una entidad de servicio que se puede usar para representar una aplicación de línea de negocio (LOB) o un servidor local, como Microsoft Exchange, SharePoint o Lync en Microsoft Azure Active Directory como objetos de entidad de servicio. Agregar una nueva aplicación como una entidad de seguridad de servicio permite a esa aplicación autenticarse en otros servicios, como Microsoft Office 365.

Ejemplos

Ejemplo 1: Creación de una entidad de servicio

PS C:\> New-MsolServicePrincipal -ServicePrincipalNames @("MyApp/myApp.com") -DisplayName "My Application"

Este comando crea una entidad de servicio. En este ejemplo, la entidad de servicio se crea con el nombre de entidad de seguridad de servicio MyApp/myApp.com, el nombre para mostrar Mi aplicación y usará una clave simétrica de 256 bits generada automáticamente para comprobar la aplicación. Esta clave será válida durante un año a partir de hoy.

Ejemplo 2: Creación de una entidad de servicio que usa un certificado X509

PS C:\> $cer = New-Object System.Security.Cryptography.X509Certificates.X509Certificate
PS C:\> $cer.Import("C:\temp\myapp.cer")
PS C:\> $binCert = $cer.GetRawCertData()
PS C:\> $credValue = [System.Convert]::ToBase64String($binCert);
PS C:\> New-MsolServicePrincipal -ServicePrincipalNames @("MyApp/myApp.com") -DisplayName "My Application" -Type asymmetric -Value $credValue

En este ejemplo se crea una entidad de servicio. En este ejemplo, la entidad de servicio se crea con el nombre de entidad de seguridad de servicio MyApp/myApp.com, el nombre para mostrar Mi aplicación y usa el certificado X509 proporcionado myapp.cer que está configurado con una clave asimétrica codificada en base 64.

Parámetros

-AccountEnabled

-Addresses

-AppPrincipalId

-DisplayName

-EndDate

-ServicePrincipalNames

-StartDate

-TenantId

-Type

-Usage

-Value

Salidas

Microsoft.Online.Administration.ServicePrincipalExtended

Este cmdlet devuelve la entidad de servicio que agregó. Esto incluye la siguiente información:

• Idobjeto. Identificador único de la entidad de servicio.
• AppPrincipalId. Identificador de aplicación de la entidad de servicio.
• DisplayName. Nombre descriptivo de la entidad de servicio.
• ServicePrincipalName. Lista de nombres de entidad de seguridad de servicio (SPN) asociados a la entidad de servicio.
• TrustedForDelegation. Valor que indica si se permite la entidad de servicio para la delegación.
• AccountEnabled. Valor que indica si la cuenta está habilitada.

También recupera la lista de credenciales que se agregaron. Cada objeto de credencial contiene la siguiente información:

• Type (Tipo). Tipo de credencial de entidad de servicio (Asimétrica/Simétrica/Otro).
• Value. Valor de la credencial. Si el tipo de credencial es certificado, representa el certificado codificado en base 64. Si el tipo de credencial es simétrico, representa una clave AES.
• KeyGroupId. Identificador reservado para uso interno.
• KeyId. Identificador único de la clave.
• StartDate. Fecha de inicio efectiva del uso de credenciales.
• Enddate. Fecha de finalización efectiva del uso de credenciales.
• Uso. Especifica si la credencial se usa para firmar o comprobar un token.

Vínculos relacionados

• Get-MsolServicePrincipal
• New-MsolServicePrincipalAddresses
• Remove-MsolServicePrincipal
• Set-MsolServicePrincipal