Compartir a través de

Set-App

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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 se haya instalado (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 parte de 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 Administrar el acceso de usuario a complementos para Outlook en Exchange Server y Administrar la implementación de complementos en el Centro de administración de Microsoft 365.

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 organización denominada FinanceTestApp, que se instaló para todos los usuarios de la organización, para que se proporcione a los miembros del grupo Del equipo financiero y se habilite 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 organización denominada FinanceTestApp en toda la organización y se oculta de la vista del 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, 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 demás cmdlets (por ejemplo, los cmdlets 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
Required:False
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 admitidos 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
Required:False
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
Required:False
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 admitidos son:

  • $true: la aplicación está habilitada para los usuarios especificados. Este es el valor predeterminado.
  • $false: La aplicación no está habilitada para los usuarios 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

El parámetro Identity especifica el valor de AppID (GUID) de la aplicación que desea 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
Required:True
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
Required:False
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 desea modificar se encuentra en un catálogo privado. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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 Outlook en la Web Opciones. 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. Todos los demás usuarios no ven esta aplicación organizativa en su vista de administración, ni se activarán en sus elementos de correo o calendario. También se impide que los usuarios especificados instalen su propia instancia de esta aplicación. No se impide que los usuarios que no están en la lista instalen su propia instancia de esta aplicación.

Este parámetro se usa con el modificador OrganizationApp.

Type:ClientExtensionProvidedTo
Position:Named
Default value:None
Required:False
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 está moviendo 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 electrónico
  • 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
Required:False
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
Required:False
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

Input types

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

Output types

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.