Update-AzureRmADServicePrincipal

Referencia

Módulo:: AzureRM.Resources

Novedades una entidad de servicio de Microsoft Entra existente.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente 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 se mantiene ni se admite, colocando cualquier uso continuado 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.

Syntax

Update-AzureRmADServicePrincipal
      -ObjectId <Guid>
      [-DisplayName <String>]
      [-Homepage <String>]
      [-IdentifierUri <String[]>]
      [-KeyCredential <KeyCredential[]>]
      [-PasswordCredential <PasswordCredential[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADServicePrincipal
      -ApplicationId <Guid>
      [-Homepage <String>]
      [-IdentifierUri <String[]>]
      [-KeyCredential <KeyCredential[]>]
      [-PasswordCredential <PasswordCredential[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADServicePrincipal
      -ServicePrincipalName <String>
      [-DisplayName <String>]
      [-Homepage <String>]
      [-IdentifierUri <String[]>]
      [-KeyCredential <KeyCredential[]>]
      [-PasswordCredential <PasswordCredential[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADServicePrincipal
      -InputObject <PSADServicePrincipal>
      [-DisplayName <String>]
      [-Homepage <String>]
      [-IdentifierUri <String[]>]
      [-KeyCredential <KeyCredential[]>]
      [-PasswordCredential <PasswordCredential[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Novedades una entidad de servicio de Microsoft Entra existente. Para actualizar las credenciales asociadas a esta entidad de servicio, use el cmdlet New-AzureRmADSpCredential. Para actualizar las propiedades asociadas a la aplicación subyacente, use el cmdlet Update-AzureRmADApplication.

Ejemplos

Ejemplo 1: actualización del nombre para mostrar de una entidad de servicio

PS C:\> Update-AzureRmADServicePrincipal -ObjectId 784136ca-3ae2-4fdd-a388-89d793e7c780 -DisplayName MyNewDisplayName

Novedades el nombre para mostrar de la entidad de servicio con el identificador de objeto '784136ca-3ae2-4fdd-a388-89d793e7c780' para que sea 'MyNewDisplayName'.

Ejemplo 2: actualización del nombre para mostrar de una entidad de servicio mediante la canalización

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 784136ca-3ae2-4fdd-a388-89d793e7c780 | Update-AzureRmADServicePrincipal -DisplayName MyNewDisplayName

Obtiene la entidad de servicio con el identificador de objeto '784136ca-3ae2-4fdd-a388-89d793e7c780' y canaliza el cmdlet Update-AzureRmADServicePrincipal para actualizar el nombre para mostrar de la entidad de servicio a "MyNewDisplayName".

Parámetros

-ApplicationId

Identificador de aplicación de la entidad de servicio que se va a actualizar.

Tipo:	Guid
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Nombre para mostrar de la entidad de servicio.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Homepage

Página principal de la entidad de servicio.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentifierUri

Identificador URI de la entidad de servicio.

Tipo:	String[]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Objeto que representa la entidad de servicio que se va a actualizar.

Tipo:	PSADServicePrincipal
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-KeyCredential

Credenciales de clave para la entidad de servicio.

Tipo:	KeyCredential[]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

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

Tipo:	Guid
Aliases:	ServicePrincipalObjectId
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PasswordCredential

Credenciales de contraseña para la entidad de servicio.

Tipo:	PasswordCredential[]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipalName

SpN de la entidad de servicio que se va a actualizar.

Tipo:	String
Aliases:	SPN
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Guid

String

PSADServicePrincipal

Parámetros: InputObject (ByValue)

Salidas