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-000000000000In 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.