New-EdgeSubscription
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet New-EdgeSubscription per esportare un file sottoscrizione Edge da un server Trasporto Edge e per importare il file sottoscrizione Edge su un server Cassette postali.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-EdgeSubscription
[-AccountExpiryDuration <TimeSpan>]
[-Confirm]
[-CreateInboundSendConnector <Boolean>]
[-CreateInternetSendConnector <Boolean>]
[-DomainController <Fqdn>]
[-FileData <Byte[]>]
[-FileName <LongPath>]
[-Force]
[-Site <AdSiteIdParameter>]
[-WhatIf]
[<CommonParameters>] Descrizione
Il server Trasporto Edge non ha accesso ad Active Directory. Tutte le informazioni sulla configurazione e sul destinatario vengono archiviate nell'istanza di Active Directory Lightweight Directory Services (AD LDS). Il cmdlet New-EdgeSubscription crea il file della sottoscrizione Edge che verrà importato in un server Cassette postali nel sito di Active Directory a cui si vuole sottoscrivere questo server Trasporto Edge.
È 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-EdgeSubscription -FileName "C:\Data\EdgeSubscription.xml"In questo esempio viene creato il file sottoscrizione Edge. Deve essere eseguito sul server Trasporto Edge.
Esempio 2
$Temp = [System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')
New-EdgeSubscription -FileData $Temp -Site "Default-First-Site-Name"In questo esempio il file della sottoscrizione Edge generato nell'esempio 1 viene importato nel sito di Active Directory Default-First-Site-Name. L'importazione del file sottoscrizione Edge completa il processo di sottoscrizione Edge. È necessario eseguire questo comando sul server Cassette postali.
Il primo comando legge i dati dal file sottoscrizione Edge e gli archivia in una variabile temporanea come oggetto di dati codificati in byte. Il secondo comando completa il processo di sottoscrizione Edge.
Esempio 3
New-EdgeSubscription -FileData ([System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')) -Site "Default-First-Site-Name"Questo esempio importa anche il file di sottoscrizione Edge generato nell'esempio 1 nel sito di Active Directory Default-First-Site-Name; tuttavia, il risultato finale viene ottenuto usando un comando . È necessario eseguire questo comando sul server Cassette postali.
Parametri
-AccountExpiryDuration
Il parametro AccountExpiryDuration specifica la scadenza dell'account di replica bootstrap (ESBRA) di EdgeSync creato da questo comando.
Per specificare un valore, immetterlo come intervallo di tempo: dd.hh:mm:ss dove dd = days, hh = hours, mm = minuti e ss = secondi.
Il valore per questo parametro non deve essere inferiore a 00:02:00 o 2 minuti. Il valore predefinito è 24:00:00 o 24 ore.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-CreateInboundSendConnector
Il parametro CreateInboundSendConnector specifica se creare il connettore di invio per connettere il server Trasporto Edge e i server Trasporto Hub. Il valore predefinito è $true. Lo spazio degli indirizzi del connettore di invio è impostato su "--", gli smart host sono impostati su "--", il server Trasporto Edge viene impostato come server di origine e il routing DNS (Domain Name System) è disabilitato. Questo parametro viene utilizzato solo quando si esegue il comando sul server Trasporto Hub.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-CreateInternetSendConnector
Il parametro CreateInternetSendConnector consente di specificare se creare il connettore di invio per connettersi a Internet. Il valore predefinito è $true. Lo spazio indirizzo del connettore di invio verrà impostato su tutti i domini (*), il server Trasporto Edge verrà impostato come server di origine e il routing DNS (Domain Name System) verrà abilitato. Questo parametro viene utilizzato solo quando si esegue il comando sul server Trasporto Hub.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
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.
Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-FileData
Il parametro di FileData consente di specificare l'oggetto di dati codificati in byte che contiene le informazioni sul file sottoscrizione Edge.
Per un valore valido per questo parametro è necessario leggere il file in un oggetto con codifica byte usando la sintassi seguente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). È possibile usare questo comando come valore del parametro oppure scrivere l'output in una variabile ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usare la variabile come valore del parametro ($data).
È possibile usare questo parametro solo quando si esegue il comando in un server Cassette postali.
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-FileName
Il parametro FileName consente di specificare il percorso completo del file sottoscrizione Edge.
È possibile utilizzare questo parametro solo quando questo comando è in esecuzione su un server Trasporto Hub.
| Type: | LongPath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
Questa opzione è utile negli scenari seguenti:
- Ignorare la conferma quando si esegue lo script del comando Sottoscrizione Edge.
- Ricreare una sottoscrizione del server Trasporto Edge e sovrascrivere le informazioni di configurazione esistenti.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Site
Il parametro Site consente di specificare il nome del sito di Active Directory che contiene i server Cassette postali a cui sono associati i server Trasporto Edge. Questo parametro è richiesto ed utilizzato solo quando si esegue il comando su un server Cassette postali.
| Type: | AdSiteIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.