Compartir a través de

Remove-AzureRmADSpCredential

  • Referencia
Módulo:
AzureRM.Resources

Quita una credencial de una entidad de servicio.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Remove-AzureRmADSpCredential
      -ObjectId <Guid>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -ServicePrincipalName <String>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -DisplayName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -ServicePrincipalObject <PSADServicePrincipal>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-AzureRmADSpCredential se puede usar para quitar una clave de credencial de una entidad de servicio en el caso de un riesgo o como parte de la expiración de la sustitución de claves de credenciales. La entidad de servicio se identifica proporcionando el identificador de objeto o el nombre de entidad de seguridad de servicio (SPN). La credencial que se va a quitar se identifica mediante su identificador de clave si se va a quitar una credencial individual o con un modificador "All" para eliminar todas las credenciales asociadas a la entidad de servicio.

Ejemplos

Ejemplo 1: Eliminación de una credencial específica de una entidad de servicio

PS C:\> Remove-AzureRmADSpCredential -ObjectId 00001111-aaaa-2222-bbbb-3333cccc4444 -KeyId 9044423a-60a3-45ac-9ab1-09534157ebb

Quita la credencial con el identificador de clave '9044423a-60a3-45ac-9ab1-09534157ebb' de la entidad de servicio con el identificador de objeto '00001111-aaaa-2222-bbbb-3333cccccc4444'.

Ejemplo 2: Eliminación de todas las credenciales de una entidad de servicio

PS C:\> Remove-AzureRmADSpCredential -ServicePrincipalName http://test123

Quita todas las credenciales de la entidad de servicio con el SPN "http://test123".

Ejemplo 3: Eliminación de todas las credenciales de una entidad de servicio mediante la canalización

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 00001111-aaaa-2222-bbbb-3333cccc4444 | Remove-AzureRmADSpCredential

Obtiene la entidad de servicio con el identificador de objeto '00001111-aaaa-2222-bbbb-3333cccc4444' y canaliza el cmdlet Remove-AzureRmADSpCredential para quitar todas las credenciales de esa entidad de servicio.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayName

Nombre para mostrar de la entidad de servicio.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Force

Cambie para eliminar credenciales sin confirmación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KeyId

Especifica la clave de credencial que se va a quitar. Los identificadores de clave de una entidad de servicio se pueden obtener mediante el cmdlet Get-AzureRmADSpCredential.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ObjectId

Identificador de objeto de la entidad de servicio de la que se van a quitar las credenciales.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Si se especifica esto, se devolverá true si el comando se realizó correctamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServicePrincipalName

Nombre (SPN) de la entidad de servicio de la que se van a quitar las credenciales.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServicePrincipalObject

Objeto de entidad de servicio del que se van a quitar las credenciales.

Tipo:PSADServicePrincipal
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Guid

String

PSADServicePrincipal

Parámetros: ServicePrincipalObject (ByValue)

Salidas

Boolean