Compartir a través de

Set-PartnerApplication

Módulo:
Exchange PowerShell

Este cmdlet solo funciona en Exchange local.

Use el cmdlet Set-PartnerApplication para configurar las configuraciones de las aplicaciones asociadas en organizaciones locales de Exchange.

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

ACSTrustApplication 

Set-PartnerApplication
    [-Identity] <PartnerApplicationIdParameter>
    [-ApplicationIdentifier <String>]
    [-Realm <String>]
    [-AcceptSecurityIdentifierInformation <Boolean>]
    [-AccountType <SupportedAccountType>]
    [-ActAsPermissions <String[]>]
    [-AppOnlyPermissions <String[]>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-IssuerIdentifier <String>]
    [-LinkedAccount <UserIdParameter>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

AuthMetadataUrl 

Set-PartnerApplication
    [-Identity] <PartnerApplicationIdParameter>
    [-AuthMetadataUrl <String>]
    [-TrustAnySSLCertificate]
    [-AcceptSecurityIdentifierInformation <Boolean>]
    [-AccountType <SupportedAccountType>]
    [-ActAsPermissions <String[]>]
    [-AppOnlyPermissions <String[]>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-IssuerIdentifier <String>]
    [-LinkedAccount <UserIdParameter>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

RefreshAuthMetadata 

Set-PartnerApplication
    [-Identity] <PartnerApplicationIdParameter>
    [-RefreshAuthMetadata]
    [-AcceptSecurityIdentifierInformation <Boolean>]
    [-AccountType <SupportedAccountType>]
    [-ActAsPermissions <String[]>]
    [-AppOnlyPermissions <String[]>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-IssuerIdentifier <String>]
    [-LinkedAccount <UserIdParameter>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

Puede configurar aplicaciones asociadas como SharePoint para acceder a los recursos de Exchange. Use el cmdlet New-PartnerApplication para crear una configuración de aplicación de asociado para una aplicación que necesita acceder a los recursos de Exchange. Para obtener más información, vea Planear la integración de Exchange 2016 con SharePoint y Skype Empresarial. Se recomienda utilizar el script Configure-EnterprisePartnerApplication.ps1 de la carpeta %ExchangeInstallPath%Scripts para configurar las aplicaciones de socios.

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-PartnerApplication HRApp -RefreshAuthMetadata

En este ejemplo se actualizan los metadatos de autorización de la aplicación de socio HRApp.

Parámetros

-AcceptSecurityIdentifierInformation

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro AcceptSecurityIdentifierInformation especifica si Exchange debe aceptar identificadores de seguridad (SID) de otro bosque de Active Directory de confianza para la aplicación asociada. De forma predeterminada, las nuevas aplicaciones de socio se configuran para que no acepten SID de otro bosque. Si ha realizado una implementación con un bosque de confianza, establezca el parámetro en $true.

Propiedades de parámetro

Tipo:Boolean
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

-AccountType

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro AccountType especifica el tipo de cuenta de Microsoft necesario para la aplicación asociada. Los valores admitidos son:

  • OrganizationalAccount: este valor es el valor predeterminado.
  • ConsumerAccount

Propiedades de parámetro

Tipo:SupportedAccountType
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

-ActAsPermissions

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro ActAsPermissions especifica los permisos de delegado que se permiten para la aplicación asociada. Puede especificar distintos valores separados por comas.

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

-ApplicationIdentifier

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro ApplicationIdentifier especifica un identificador de aplicaciones exclusivo para la aplicación de socio que utiliza un servidor de autorización.

Propiedades de parámetro

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

Conjuntos de parámetros

ACSTrustApplication
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

-AppOnlyPermissions

Aplicable: Exchange Server 2013

Este parámetro solo está disponible en Exchange Server 2013.

Este parámetro está reservado para uso interno de Microsoft.

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

-AuthMetadataUrl

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

El parámetro AuthMetadataUrl especifica la dirección URL de la que Exchange puede recuperar el documento AuthMetadata para una aplicación asociada que no usa un servidor de autorización.

Propiedades de parámetro

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

Conjuntos de parámetros

AuthMetadataUrl
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

-Confirm

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, 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

-DomainController

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propiedades de parámetro

Tipo:Fqdn
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

-Enabled

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Enabled especifica si se ha habilitado la aplicación de socio. De forma predeterminada, las nuevas aplicaciones de socio están habilitadas. Establece el parámetro en $false para crear la configuración de la aplicación en un estado deshabilitado.

Propiedades de parámetro

Tipo:Boolean
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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, complemento de seguridad integrado para buzones locales

El parámetro Identity especifica la aplicación de asociado que desea modificar. Puede usar cualquier valor que identifique de forma única la aplicación asociada. Por ejemplo:

  • Nombre
  • ApplicationID (valor GUID)
  • Nombre completo (DN)
  • GUID

Propiedades de parámetro

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

Conjuntos de parámetros

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

-IssuerIdentifier

Aplicable: Exchange Server 2013

Este parámetro solo está disponible en Exchange Server 2013.

Este parámetro está reservado para uso interno de Microsoft.

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

-LinkedAccount

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro LinkedAccount especifica una cuenta de usuario vinculada de Active Directory para la aplicación. Exchange evalúa los permisos de Access Control basado en rol (RBAC) para la cuenta vinculada al autorizar un token usado para realizar una tarea.

Propiedades de parámetro

Tipo:UserIdParameter
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

-Name

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Name especifica un nuevo nombre para la aplicación de socio.

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

-Realm

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

El parámetro Realm especifica un dominio de seguridad para la aplicación de socio. Si el token procede de un dominio que no es un dominio aceptado, Exchange comprueba el dominio especificado en el token. En este escenario, solo los tokens con el mismo dominio especificado en la aplicación asociada pueden acceder a los recursos de Exchange.

Propiedades de parámetro

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

Conjuntos de parámetros

ACSTrustApplication
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

-RefreshAuthMetadata

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

El modificador RefreshAuthMetadata actualiza los metadatos de autenticación desde el servidor de autorización. 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

Conjuntos de parámetros

RefreshAuthMetadata
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

-TrustAnySSLCertificate

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

El modificador TrustAnySSLCertificate permite a Exchange aceptar certificados de entidades de certificación (CA) que no son de confianza. No es necesario especificar un valor con este modificador.

No recomendamos usar este interruptor en un entorno de producción.

Propiedades de parámetro

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

Conjuntos de parámetros

AuthMetadataUrl
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

-WhatIf

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, 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.

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.