New-AutodiscoverVirtualDirectory
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-08-17
Mit dem Cmdlet New-AutodiscoverVirtualDirectory können Sie ein neues virtuelles AutoErmittlungsverzeichnis auf einem Microsoft Exchange 2007-Computer erstellen, auf dem die Serverfunktion ClientAccess installiert ist. Wenn Ihre Organisation über mehrere E-Mail-Domänen verfügt, von denen jede einen eigenen AutoErmittlungsstandort und ein entsprechendes virtuelles Verzeichnis benötigt, verwenden Sie dieses Cmdlet, um ein neues virtuelles AutoErmittlungsverzeichnis auf einer neuen Webseite zu erstellen.
Syntax
New-AutodiscoverVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Detaillierte Beschreibung
Mit dem Cmdlet New-AutodiscoverVirtualDirectory erstellen Sie ein neues virtuelles AutoErmittlungsverzeichnis auf einem Exchange 2007-Clientzugriffsserver. Wenn Ihre Organisation über mehrere E-Mail-Domänen verfügt, von denen jede einen eigenen AutoErmittlungsstandort und ein entsprechendes virtuelles Verzeichnis benötigt, verwenden Sie dieses Cmdlet, um ein neues virtuelles AutoErmittlungsverzeichnis auf einer neuen Webseite zu erstellen.
Hinweis
Wenn Sie ein neues AutoErmittlungsverzeichnis erstellen, sollten Sie SSL (Secure Sockets Layer) für den AutoErmittlungsdienst aktivieren.
Damit Sie das Cmdlet New-AutodiscoverVirtualDirectory ausführen können, muss dem verwendeten Konto die Rolle Exchange-Administrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Zielserver angehören.
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
ApplicationRoot |
Optional |
System.String |
Dieser Parameter legt den Metabasepfad des virtuellen Verzeichnisses fest. Standardmäßig entspricht dieser Pfad der Website, in der das virtuelle Verzeichnis erstellt wird. |
AppPoolId |
Optional |
System.String |
Dieser Parameter legt den Programmpool fest, der mit dem virtuellen Verzeichnis verwendet werden kann. |
BasicAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Standardauthentifizierung für das virtuelle AutoErmittlungsverzeichnis aktiviert ist. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Benutzer, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden. |
DigestAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Digestauthentifizierung für das virtuelle AutoErmittlungsverzeichnis aktiviert ist. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQND) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Cmdlet den Parameter DomainController hinzu. |
ExternalUrl |
Optional |
System.Uri |
Dieser Parameter gibt den zu verwendenden URL an, wenn außerhalb der Netzwerkfirewall auf das virtuelle Verzeichnis zugegriffen wird. |
InternalUrl |
Optional |
System.Uri |
Dieser Parameter gibt den zu verwendenden URL an, wenn innerhalb der Netzwerkfirewall auf das virtuelle Verzeichnis zugegriffen wird. |
Path |
Optional |
System.String |
Dieser Parameter legt das Verzeichnis fest, das die Systemdateien des virtuellen Verzeichnisses enthält. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet das Cmdlet die Konfiguration dieses Objekts zum Erstellen einer Kopie des Objekts auf einem lokalen oder Zielserver. |
WebSiteName |
Optional |
System.String |
Dieser Parameter gibt den Namen der IIS-Website (Internet Information Services) an, unter der das virtuelle Verzeichnis erstellt werden soll. |
WindowsAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Integrierte Windows-Authentifizierung für das virtuelle AutoErmittlungsverzeichnis aktiviert ist. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter weist den Befehl an, die Aktionen zu simulieren, die für das Objekt ausgeführt würden. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Im folgenden Codebeispiel wird ein neues virtuelles AutoErmittlungsverzeichnis auf der Website autodiscover.contoso.com erstellt und die Benutzerverbindung über die Integrierte Windows-Authentifizierung oder die Digestauthentifizierung über SSL als Voraussetzung eingerichtet.
New-AutoDiscoverVirtualDirectory -websitename "autodiscover.contoso.com" -WindowsAuthentication $true -DigestAuthentication $true