Set-MsolServicePrincipal

  • Referencia
Módulo:
MSOnline

Actualiza una entidad de servicio en Microsoft Azure Active Directory.

Sintaxis

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.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

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

-AppPrincipalId

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

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

-DisplayName

Especifica el nombre para mostrar de la entidad de servicio.

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

-ObjectId

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

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

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