Get-MsolServicePrincipalCredential

  • Referencia
Módulo:
MSOnline

Obtiene las credenciales asociadas a una entidad de servicio.

Syntax

Get-MsolServicePrincipalCredential
   -ObjectId <Guid>
   -ReturnKeyValues <Boolean>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipalCredential
   -ReturnKeyValues <Boolean>
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

El cmdlet Get-MsolServicePrincipalCredential obtiene las credenciales asociadas a una entidad de servicio.

Ejemplos

Ejemplo 1: Obtención de propiedades de credenciales

PS C:\> Get-MsolServicePrincipalCredential -ServicePrincipalName "MyApp/myApp.com"

Este comando obtiene todas las propiedades de credencial, excepto el valor de credencial, que están asociados al nombre de entidad de seguridad de servicio (SPN) MyApp/myApp.com. Un SPN debe seguir el formato appClass/hostname, donde appClass representa la clase de aplicación ("MyApp") y el nombre de host representa el nombre de host de la aplicación (myApp.com).

Parámetros

-AppPrincipalId

Especifica el identificador de aplicación de la entidad de servicio para la que se van a obtener las credenciales.

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

-ObjectId

Especifica el identificador de objeto único de la entidad de servicio para la que se van a obtener las credenciales.

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

-ReturnKeyValues

Indica si este cmdlet devuelve valores de clave.

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

-ServicePrincipalName

Especifica el nombre de la entidad de servicio desde la que se van a obtener las credenciales. Un SPN debe usar uno de los siguientes formatos:

  • appName
  • appName/hostname
  • una dirección URL válida

AppName representa el nombre de la aplicación. El nombre de host representa la entidad de URI de la aplicación.

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

-TenantId

Especifica el identificador único del inquilino en el que se va a realizar la operación. El valor predeterminado es el inquilino del usuario actual. Este parámetro solo se aplica a los usuarios asociados.

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

Salidas

Microsoft.Online.Administration.ServicePrincipalCredential[]

Este cmdlet devuelve las credenciales asociadas a una entidad de servicio. Cada objeto devuelto contiene la siguiente información:

  • Type (Tipo). Tipo de credencial de entidad de servicio (asimétrica, simétrica o contraseña).
  • 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.