Compartir a través de


Set-ServicePrincipal

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Set-ServicePrincipal para cambiar las entidades de servicio de la organización basada en la nube.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

Default (valor predeterminado)

Set-ServicePrincipal
    [-Identity] <ServicePrincipalIdParameter>
    [-Confirm]
    [-DisplayName <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

Puede usar este cmdlet para cambiar solo DisplayName. Si AppId/ObjectId es incorrecto, elimine la entidad de servicio y cree una nueva.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Set-ServicePrincipal -Identity dc873ad4-0397-4d74-b5c0-897cd3a94731 -DisplayName "Another App Name"

En este ejemplo se establece la entidad de servicio en Exchange Online con el nombre para mostrar especificado.

Parámetros

-Confirm

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayName

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

El parámetro DisplayName especifica el nombre descriptivo de la entidad de servicio. Si el nombre incluye espacios, escríbalo entre comillas (").

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

El parámetro Identity especifica la entidad de servicio que desea modificar. Puede usar cualquier valor que identifique de forma única la entidad de servicio. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
  • AppId
  • ObjectId

Propiedades de parámetro

Tipo:ServicePrincipalIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.