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
ACSTrustApplication
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>]
AuthMetadataUrl
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, ad esempio 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. 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
New-PartnerApplication -Name HRApp -ApplicationIdentifier 00000006-0000-0dd1-ac00-000000000000
In questo esempio viene creata una nuova applicazione partner HRApp denominata HRApp.
Parametri
-AcceptSecurityIdentifierInformation
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Online
Il parametro AccountType consente di specificare il tipo di account Microsoft necessario per l'applicazione partner. I valori validi sono:
- OrganizationalAccount (valore predefinito)
- 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
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 |
-ApplicationIdentifier
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ACSTrustApplication
| Posizione: | Named |
| Obbligatorio: | True |
| 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
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AuthMetadataUrl
| Posizione: | Named |
| Obbligatorio: | True |
| 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 Online
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
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 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 |
-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 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 Online
Il parametro Name consente di specificare un 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: | 1 |
| Obbligatorio: | True |
| 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
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 |
-TrustAnySSLCertificate
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 Online
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.