Condividi tramite


New-PartnerApplication

Questo cmdlet funziona solo in Exchange locale.

Usare il cmdlet New-PartnerApplication per creare configurazioni di applicazioni partner nelle organizzazioni di Exchange locali.

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

Sintassi

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

Descrizione

È possibile configurare applicazioni partner come Microsoft 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. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. 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

New-PartnerApplication -Name HRApp -ApplicationIdentifier 00000006-0000-0dd1-ac00-000000000000

In questo esempio viene creata una nuova applicazione partner HRApp denominata HRApp.

Parametri

-AcceptSecurityIdentifierInformation

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.

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

-AccountType

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

  • OrganizationalAccount (valore predefinito)
  • ConsumerAccount
Type:SupportedAccountType
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

-ActAsPermissions

Questo parametro è disponibile solo in Exchange Server 2013.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

-ApplicationIdentifier

Il parametro ApplicationIdentifier consente di specificare l'identificatore univoco dell'applicazione per l'applicazione partner che utilizza un server di autorizzazione. Quando si specifica un valore per il parametro ApplicationIdentifier, è necessario specificare anche il parametro UseAuthServer.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-AppOnlyPermissions

Questo parametro è disponibile solo in Exchange Server 2013.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

-AuthMetadataUrl

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. Quando si specifica il parametro AuthMetadataUrl per un'applicazione partner, non è possibile specificare i parametri ApplicationIdentifier e UseAuthServer.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

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-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. 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.
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

-DomainController

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.

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

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.

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

-IssuerIdentifier

Questo parametro è disponibile solo in Exchange Server 2013.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

-LinkedAccount

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à.

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

-Name

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Realm

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.

Type:String
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

-TrustAnySSLCertificate

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.

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

-WhatIf

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.

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

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.