Set-MsolServicePrincipal

  • Referencia
Módulo:
MSOnline

Novedades una entidad de servicio en Microsoft Azure Active Directory.

Syntax

Set-MsolServicePrincipal
   [-ObjectId <Guid>]
   [-AppPrincipalId <Guid>]
   [-DisplayName <String>]
   [-ServicePrincipalNames <String[]>]
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

El cmdlet Set-MsolServicePrincipal actualiza una entidad de servicio en Microsoft Azure Active Directory. Se puede usar para actualizar el nombre para mostrar, habilitar o deshabilitar la entidad de seguridad de servicio (de confianza para delegación), los nombres de entidad de seguridad de servicio (SPN) o las direcciones.

Ejemplos

Ejemplo 1: Cambio de propiedades en una entidad de servicio

PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")

Este comando actualiza las propiedades de la entidad de servicio especificada. En este ejemplo, especifica las actualizaciones del nombre para mostrar y los SPN. Con esto, se sobrescribirá la configuración anterior.

Ejemplo 2: Cambio de direcciones en una entidad de servicio

PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a

Este comando actualiza las direcciones de una entidad de servicio. En este ejemplo, las direcciones existentes que se crearon anteriormente ("myApp1.com", "myApp2.com") mediante el cmdlet New-MsolServicePrincipalAddresses están asociados a la entidad de servicio.

Parámetros

-AccountEnabled

Esta propiedad está reservada para un uso futuro.

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

-Addresses

Especifica la lista de direcciones con la que actualizar y sobrescribir la lista existente. Si no especifica este parámetro, la propiedad existente no se actualiza. Si especifica una lista vacía, se borrarán las direcciones existentes. Use el cmdlet New-MsolServicePrincipalAddress para ayudar a crear el objeto de lista Direcciones.

Type:RedirectUri[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AppPrincipalId

Especifica el identificador de aplicación único asociado a la entidad de servicio que se va a actualizar.

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

-DisplayName

Especifica el nombre para mostrar de la entidad de servicio.

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

-ObjectId

Especifica el identificador de objeto único de la entidad de servicio que se va a actualizar.

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

-ServicePrincipalNames

Especifica la lista de SPN con las que actualizar y sobrescribir el existente. Si no especifica este parámetro, la propiedad existente no se actualiza. Si especifica una lista vacía, se borran los SPN existentes, excepto el SPN que contiene el valor AppId de la entidad de servicio. Un SPN debe usar uno de los siguientes formatos:

  • appName
  • appName/hostname
  • una dirección URL válida
Type:String[]
Position:Named
Default value:None
Required:False
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