Condividi tramite


Set-PartnerApplication

Questo cmdlet funziona solo in Exchange locale.

Usare il cmdlet Set-PartnerApplication per configurare le configurazioni delle applicazioni partner nelle organizzazioni di Exchange locali.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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>]

Descrizione

È possibile configurare applicazioni partner come SharePoint per accedere alle risorse di Exchange. Usare il cmdlet New-PartnerApplication per creare una configurazione dell'applicazione partner per un'applicazione che deve accedere alle risorse di Exchange. Per informazioni dettagliate, vedere Pianificare l'integrazione di Exchange 2016 con SharePoint e Skype for Business. Si consiglia di utilizzare lo script Configure-EnterprisePartnerApplication.ps1 nella cartella %ExchangeInstallPath%Scripts per configurare le applicazioni partner.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-PartnerApplication HRApp -RefreshAuthMetadata

In questo esempio vengono aggiornati i metadati di autorizzazione per l'applicazione partner HRApp.

Parametri

-AcceptSecurityIdentifierInformation

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

Il parametro AcceptSecurityIdentifierInformation specifica se Exchange deve accettare identificatori di sicurezza (SID) da un'altra foresta di Active Directory attendibile per l'applicazione partner. Per impostazione predefinita, le nuove applicazioni partner vengono configurate per non accettare SID da un'altra foresta. Se si sta effettuando la distribuzione con una foresta trusted, impostare questo parametro su $true.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AccountType

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

Il parametro AccountType consente di specificare il tipo di account Microsoft necessario per l'applicazione partner. I valori validi sono:

  • OrganizationalAccount: questo valore è l'impostazione predefinita
  • ConsumerAccount

Proprietà dei parametri

Tipo:SupportedAccountType
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ActAsPermissions

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

Il parametro ActAsPermissions consente di specificare le autorizzazioni delegate consentite per l'applicazione partner. È possibile specificare più valori separati da virgole.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ApplicationIdentifier

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

Il parametro ApplicationIdentifier consente di specificare l'identificatore univoco dell'applicazione per l'applicazione partner che utilizza un server di autorizzazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ACSTrustApplication
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AppOnlyPermissions

Applicabile: Exchange Server 2013

Questo parametro è disponibile solo in Exchange Server 2013.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AuthMetadataUrl

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro AuthMetadataUrl specifica l'URL da cui Exchange può recuperare il documento AuthMetadata per un'applicazione partner che non usa un server di autorizzazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AuthMetadataUrl
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DomainController

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Enabled

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

Il parametro Enabled consente di specificare se l'applicazione partner è abilitata. Per impostazione predefinita, le nuove applicazioni partner sono abilitate. Impostare il parametro su $false per creare la configurazione dell'applicazione in uno stato disabilitato.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali

Il parametro Identity consente di specificare l'applicazione partner da modificare. È possibile usare qualsiasi valore che identifichi in modo univoco l'applicazione partner. Ad esempio:

  • Nome
  • ApplicationID (valore GUID)
  • Nome distinto (DN)
  • GUID

Proprietà dei parametri

Tipo:PartnerApplicationIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-IssuerIdentifier

Applicabile: Exchange Server 2013

Questo parametro è disponibile solo in Exchange Server 2013.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LinkedAccount

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

Il parametro LinkedAccount consente di specificare un account utente di Active Directory collegato per l'applicazione. Exchange valuta le autorizzazioni RBAC (Role Based Controllo di accesso) per l'account collegato durante l'autorizzazione di un token usato per eseguire un'attività.

Proprietà dei parametri

Tipo:UserIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

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

Il parametro Name consente di specificare un nuovo nome per l'applicazione partner.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Realm

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro Realm consente di specificare un'area di autenticazione di sicurezza per l'applicazione partner. Se il token proviene da un dominio che non è un dominio accettato, Exchange controlla l'area di autenticazione specificata nel token. In questo scenario, solo i token con la stessa area di autenticazione specificata nell'applicazione partner possono accedere alle risorse di Exchange.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ACSTrustApplication
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RefreshAuthMetadata

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

Questo parametro è disponibile solo in Exchange locale.

L'opzione RefreshAuthMetadata aggiorna i metadati di autenticazione dal server di autorizzazione. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

RefreshAuthMetadata
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TrustAnySSLCertificate

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

Questo parametro è disponibile solo in Exchange locale.

Il commutatore TrustAnySSLCertificate consente a Exchange di accettare certificati da autorità di certificazione non attendibili. Con questa opzione non è necessario specificare alcun valore.

Si consiglia di non utilizzare questa opzione in un ambiente di produzione.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AuthMetadataUrl
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.