Compartir a través de

Remove-AzureRmADServicePrincipal

  • Referencia
Módulo:
AzureRM.Resources

Elimina la entidad de servicio de Microsoft Entra.

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-AzureRmADServicePrincipal
      -ObjectId <Guid>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ApplicationId <Guid>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ServicePrincipalName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -DisplayName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -InputObject <PSADServicePrincipal>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ApplicationObject <PSADApplication>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Elimina la entidad de servicio de Microsoft Entra.

Ejemplos

Ejemplo 1: Eliminación de una entidad de servicio por identificador de objeto

PS C:\> Remove-AzureRmADServicePrincipal -ObjectId 61b5d8ea-fdc6-40a2-8d5b-ad447c678d45

Quita la entidad de servicio con el identificador de objeto '61b5d8ea-fdc6-40a2-8d5b-ad447c678d45'.

Ejemplo 2: Eliminación de una entidad de servicio por identificador de aplicación

PS C:\> Remove-AzureRmADServicePrincipal -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444

Quita la entidad de servicio con el identificador de aplicación '00001111-aaaa-2222-bbbb-3333cccc4444'.

Ejemplo 3: Eliminación de una entidad de servicio por SPN

PS C:\> Remove-AzureRmADServicePrincipal -ServicePrincipalName MyServicePrincipal

Quite la entidad de servicio con el nombre de entidad de servicio "MyServicePrincipal"

Ejemplo 4: Eliminación de una entidad de servicio mediante la canalización

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 61b5d8ea-fdc6-40a2-8d5b-ad447c678d45 | Remove-AzureRmADServicePrincipal

Obtiene la entidad de servicio con el identificador de objeto '61b5d8ea-fdc6-40a2-8d5b-ad447c678d45' y canaliza el cmdlet Remove-AzureRmADServicePrincipal para quitar esa entidad de servicio.

Ejemplo 5: Eliminación de una entidad de servicio mediante la canalización de una aplicación

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

Obtiene la aplicación con el identificador de aplicación '00001111-aaaa-2222-bbbb-3333cc4444' y canaliza el cmdlet Remove-AzureRmADServicePrincipal para quitar la entidad de servicio asociada a esa aplicación.

Parámetros

-ApplicationId

Identificador de la aplicación de la entidad de servicio.

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

-ApplicationObject

Objeto de aplicación cuya entidad de servicio se va a quitar.

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

-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 a eliminar la entidad de servicio sin confirmación.

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

-InputObject

Objeto de entidad de servicio.

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

-ObjectId

Identificador de objeto de la entidad de servicio que se va a eliminar.

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

-PassThru

Si se especifica, devuelve la entidad de servicio eliminada.

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

-ServicePrincipalName

Nombre de la entidad de seguridad de servicio.

Tipo:String
Alias:SPN
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: InputObject (ByValue)

PSADApplication

Parámetros: ApplicationObject (ByValue)

Salidas

PSADServicePrincipal

Notas

Palabras clave: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment