New-EdgeSubscription
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet New-EdgeSubscription, um eine Edge-Abonnementdatei von einem Edge-Transport-Server zu exportieren und die Edge-Abonnementdatei auf einen Postfachserver zu importieren.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
New-EdgeSubscription
[-AccountExpiryDuration <TimeSpan>]
[-Confirm]
[-CreateInboundSendConnector <Boolean>]
[-CreateInternetSendConnector <Boolean>]
[-DomainController <Fqdn>]
[-FileData <Byte[]>]
[-FileName <LongPath>]
[-Force]
[-Site <AdSiteIdParameter>]
[-WhatIf]
[<CommonParameters>] Beschreibung
Der Edge-Transport-Server hat keinen Zugriff auf Active Directory. Alle Konfigurations- und Empfängerinformationen werden in der AD LDS-Instanz (Active Directory Lightweight Directory Services) gespeichert. Das Cmdlet New-EdgeSubscription erstellt die Edgeabonnementdatei, die auf einem Postfachserver an dem Active Directory-Standort importiert wird, für den Sie diesen Edge-Transport-Server abonnieren möchten.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
New-EdgeSubscription -FileName "C:\Data\EdgeSubscription.xml"In diesem Beispiel wird die Edge-Abonnementdatei erstellt. Sie sollte auf Ihrem Edge-Transport-Server ausgeführt werden.
Beispiel 2
$Temp = [System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')
New-EdgeSubscription -FileData $Temp -Site "Default-First-Site-Name"In diesem Beispiel wird die in Beispiel 1 generierte Edgeabonnementdatei in den Active Directory-Standort Default-First-Site-Name importiert. Das Importieren der Edge-Abonnementdatei schließt den Edge-Abonnementprozess ab. Sie müssen diesen Befehl auf dem Postfachserver ausführen.
Der erste Befehl liest die Daten aus der Edge-Abonnementdatei und speichert sie in einer temporären Variablen als bytecodiertes Datenobjekt. Der zweite Befehl schließt den Edge-Abonnementprozess ab.
Beispiel 3
New-EdgeSubscription -FileData ([System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')) -Site "Default-First-Site-Name"In diesem Beispiel wird auch die in Beispiel 1 generierte Edgeabonnementdatei in den Active Directory-Standort Default-First-Site-Name importiert. Das Endergebnis wird jedoch mit einem Befehl erreicht. Sie müssen diesen Befehl auf dem Postfachserver ausführen.
Parameter
-AccountExpiryDuration
Der Parameter AccountExpiryDuration gibt an, wie bald das mit diesem Befehl erstellte EdgeSync-Bootstrapreplikationskonto (ESBRA) abläuft.
Um einen Wert anzugeben, geben Sie ihn als Zeitspanne ein: dd.hh:mm:ss, wobei dd = Tage, hh = Stunden, mm = Minuten und ss = Sekunden.
Der Wert für diesen Parameter muss mindestens 00:02:00 oder 2 Minuten betragen. Der Standardwert ist 24:00:00 oder 24 Stunden.
| 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
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
| 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
Der Parameter CreateInboundSendConnector gibt an, ob der Sendeconnector erstellt werden soll, um den Edge-Transport-Server und die Hub-Transport-Server zu verbinden. Der Standardwert ist $true. Der Adressraum des Sendeconnectors ist auf "--" festgelegt, die Smarthosts auf "--", der Edge-Transport-Server als Quellserver und das DNS-Routing (Domain Name System) ist deaktiviert. Dieser Parameter wird nur verwendet, wenn Sie den Befehl auf dem Hub-Transport-Server ausführen.
| 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
Der Parameter CreateInternetSendConnector gibt an, ob der Sendeconnector für die Verbindung mit dem Internet erstellt werden soll. Der Standardwert ist $true. Der Adressraum des Sendeconnectors ist auf alle Domänen (*) festgelegt, der Edge-Transport-Server als Quellserver und DNS-Routing ist aktiviert. Dieser Parameter wird nur verwendet, wenn Sie den Befehl auf dem Hub-Transport-Server ausführen.
| 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
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.
Der DomainController-Parameter wird auf Edge-Transport-Servern nicht unterstützt. Edge-Transport-Server verwenden die lokale Instanz von Active Directory Lightweight Directory Services (AD LDS), um Daten zu lesen und zu schreiben.
| 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
Der Parameter FileData gibt das bytecodierte Datenobjekt an, das die Informationen zur Edge-Abonnementdatei enthält.
Ein gültiger Wert für diesen Parameter erfordert, dass Sie die Datei mithilfe der folgenden Syntax in ein bytecodiertes Objekt lesen: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Sie können diesen Befehl als Parameterwert verwenden, oder Sie können die Ausgabe in eine Variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) schreiben und die Variable als Parameterwert ($data) verwenden.
Sie können diesen Parameter nur verwenden, wenn Sie den Befehl auf einem Postfachserver ausführen.
| 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
Der Parameter FileName gibt den vollständigen Pfad der Edge-Abonnementdatei an.
Sie können diesen Parameter nur verwenden, wenn Sie diesen Befehl auf einem Edge-Transport-Server ausführen.
| 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
Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.
Dieser Schalter ist in den folgenden Szenarien nützlich:
- Umgehung der Bestätigung beim Erstellen eines Skripts für den Edge-Abonnementbefehl.
- Erneutes Erstellen eines Edge-Transport-Serverabonnements und Überschreiben der vorhandenen Konfigurationsinformationen.
| 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
Der Parameter Site gibt den Namen des Active Directory-Standorts an, der die Postfachserver enthält, denen die Edge-Transport-Server zugeordnet sind. Dieser Parameter wird nur verwendet und ist nur erforderlich, wenn Sie den Befehl auf einem Postfachserver ausführen.
| 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
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
| 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 |
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.