Set-App

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Set-App para modificar la disponibilidad de las aplicaciones de la organización.

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.

Syntax

Set-App
   [-Identity] <AppIdParameter>
   [-Confirm]
   [-DefaultStateForUser <DefaultStateForUser>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [-ProvidedTo <ClientExtensionProvidedTo>]
   [-UserList <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

El cmdlet Set-App solamente se puede utilizar cuando se configura la disponibilidad de una aplicación de organización. Esta tarea requiere que la aplicación especificada ya esté instalada (por ejemplo, que la aplicación se haya instalado con el cmdlet New-App o que sea una aplicación predeterminada para Outlook).

Las aplicaciones predeterminadas de Outlook en la web y las aplicaciones que ha instalado para su uso por los usuarios de su organización se conocen como aplicaciones de la organización. Los usuarios finales no pueden quitar las aplicaciones de organización, pero sí pueden habilitarlas o deshabilitarlas. Si una aplicación es de organización (ámbito predeterminado u organización), el control de eliminación de la barra de herramientas está deshabilitado para los usuarios. Los administradores pueden quitar aplicaciones de organización. Los administradores no pueden quitar las aplicaciones predeterminadas, pero sí pueden deshabilitarlas en toda la organización.

Para obtener más información, vea Manage user access to add-ins for Outlook in Exchange Server and Manage deployment of add-ins in the Microsoft 365 admin center.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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

$a= Get-DistributionGroupMember -Identity "Finance Team"
Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -ProvidedTo SpecificUsers -UserList $a.Identity -DefaultStateForUser Enabled

En este ejemplo se cambia la aplicación de la organización denominada FinanceTestApp, que se instaló para todos los usuarios de la organización, para que se proporcionase a los miembros del grupo equipo de finanzas y se habilitara de forma predeterminada.

Ejemplo 2

Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -Enabled $false

En este ejemplo se deshabilita la aplicación de la organización denominada FinanceTestApp en toda la organización y se oculta de la vista de usuario final.

Parámetros

-Confirm

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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-DefaultStateForUser

El parámetro DefaultStateForUser especifica el estado inicial predeterminado de la aplicación de organización para los usuarios especificados. Los valores válidos son:

  • Habilitado: la aplicación de la organización está habilitada.
  • Deshabilitado: la aplicación de la organización está deshabilitada. Este es el valor predeterminado.
  • AlwaysEnabled: la aplicación de la organización está habilitada y los usuarios no pueden deshabilitarla.

Este parámetro se usa con el modificador OrganizationApp.

Type:DefaultStateForUser
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-DomainController

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Enabled

El parámetro Enabled especifica si la aplicación está disponible para los usuarios de la organización. Los valores válidos son:

  • $true: la aplicación está habilitada para los usuarios especificados. Este es el valor predeterminado.
  • $false: la aplicación no está habilitada para ningún usuario de la organización. Así se oculta de vista de usuario de la aplicación para todos los usuarios.

Esta opción reemplaza las opciones de configuración ProvidedTo, UserList y DefaultStateForUser. Esta opción no evita que los usuarios instalen su propia instancia de la aplicación si cuentan con permiso de instalación.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Identidad

El parámetro Identity especifica el AppID (valor GUID) de la aplicación que quieres modificar. Para buscar el valor GUID de una aplicación, ejecute el comando Get-App | Format-Table -Auto DisplayName,AppId.

Type:AppIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-OrganizationApp

El modificador OrganizationApp especifica que el ámbito de aplicación es a nivel de la organización (no relativa a un usuario específico). No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-PrivateCatalog

El modificador PrivateCatalog especifica que la aplicación que quieres modificar se encuentra en un catálogo privado. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online
-ProvidedTo

El parámetro ProvidedTo especifica la disponibilidad de la aplicación en la organización. Los valores válidos son:

  • Todos: la aplicación se proporciona a todos los usuarios de la organización. Este es el valor predeterminado. Cada usuario ve esta aplicación en la lista de aplicaciones instaladas en Opciones de Outlook en la web. Cuando una aplicación de la lista de aplicaciones instaladas se habilita, los usuarios pueden usar las características de esta aplicación en su correo electrónico. Se bloquea a todos los usuarios para que no instalen su propia instancia de la aplicación, incluyendo, entre otros, los usuarios con permisos para instalar aplicaciones.
  • SpecificUsers: esta aplicación se proporciona solo a los usuarios especificados por el parámetro UserList. El resto de usuarios no ven esta aplicación organizativa en su vista de administración, ni se activarán en sus elementos de correo o calendario. Los usuarios especificados también están bloqueados para instalar su propia instancia de esta aplicación. Los usuarios no registrados no están bloqueados para instalar su propia instancia de esta aplicación.

Este parámetro se usa con el modificador OrganizationApp.

Type:ClientExtensionProvidedTo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-UserList

El parámetro UserList especifica quién puede usar una aplicación organizativa. Este parámetro está limitado a 1000 usuarios. En el servicio basado en la nube, este valor es menos relevante, ya que la administración de complementos de Office se mueve a Implementación centralizada.

Los valores válidos son usuarios de buzones o de correo de la organización. Puede usar cualquier valor que identifique el usuario de forma exclusiva. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN". El tamaño máximo de la lista es de 1000 destinatarios.

Este parámetro se usa con el modificador OrganizationApp.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Entradas

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.