New-UMVirtualDirectory

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-06-28

Mit dem Cmdlet New-UMVirtualDirectory können Sie ein neues virtuelles Verzeichnis auf dem Computer mit Microsoft Exchange Server 2007 erstellen, auf dem die Serverfunktion ClientAccess installiert ist.

Syntax

New-UMVirtualDirectory [-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-UMVirtualDirectory können Sie ein neues virtuelles Unified Messaging-Verzeichnis auf einem Exchange 2007-Clientzugriffsserver erstellen. Sie können ein einzelnes oder mehrere virtuelle(s) UM-Verzeichnis(se) erstellen.

Damit Sie das Cmdlet New-UMVirtualDirectory ausführen können, muss dem verwendeten Konto die Rolle Exchange 2007-Serveradministrator 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 gibt den Pfad der Website an, der in der IIS-Metabase (Internet Information Services, Internetinformationsdienste) definiert ist. Standardmäßig ist der Pfad auf /W3SVC/1/ROOT festgelegt, wobei 1= die Standardwebsite ist.

AppPoolId

Optional

System.String

Dieser Parameter gibt den Namen des IIS-Anwendungspools an. Diese Einstellung kann in <SERVERNAME>\Application Pools auf der Website in IIS-Manager konfiguriert werden. Der Poolname ist standardmäßig auf MSExchangeUMAppPool festgelegt.

BasicAuthentication

Optional

System.Boolean

Dieser Parameter gibt an, ob für das virtuelle Verzeichnis Standardauthentifizierung aktiviert werden soll.

DigestAuthentication

Optional

System.Boolean

Dieser Parameter gibt an, ob für das virtuelle Verzeichnis Digestauthentifizierung aktiviert werden soll.

Confirm

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Administrator, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Der Standardwert lautet "$true".

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter gibt den vollqualifizierten Domänennamen (FQDN) des Domänencontrollers an, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt.

ExternalUrl

Optional

System.Uri

Dieser Parameter gibt den Hostnamen an, der verwendet wird, um von außerhalb des Umkreisnetzwerks eine Verbindung mit dem Exchange-Server herzustellen.

InternalUrl

Optional

System.Uri

Dieser Parameter legt den Hostnamen des Exchange-Serverhosts für die Verbindung von innerhalb des Umkreisnetzwerks fest.

Path

Optional

System.String

Dieser Parameter gibt den lokalen Pfad auf dem Clientzugriffsserver an, auf dem sich die UMWebservice-Dateien befinden. Der Standardspeicherort lautet %ExchangeInstallDir%\UnifiedMessaging\WebService.

TemplateInstance

Optional

System.Management.Automation.PSObject

Dieser Parameter gibt an, dass das Cmdlet die Konfiguration eines vorhandenen Objekts verwendet, wenn das Objekt diesem Parameter übergeben wird, um eine identische Kopie des Objekts auf dem lokalen oder einem Zielserver zu erstellen.

WebSiteName

Optional

System.String

Dieser Parameter gibt den Namen der Website an, auf der das neue virtuelle Verzeichnis erstellt wird. Dieser Parameter darf nicht verwendet werden, wenn ein neues virtuelles Verzeichnis auf der Standardwebsite erstellt wird.

WindowsAuthentication

Optional

System.Boolean

Dieser Parameter gibt an, ob für das virtuelle Verzeichnis integrierte Windows-Authentifizierung aktiviert werden soll.

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 Parameters WhatIf kann der Administrator die sich ergebenden Änderungen anzeigen, ohne diese Änderungen tatsächlich auszuführen. Der Standardwert lautet "$true".

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Mit diesem Codebeispiel wird ein neues virtuelles Unified Messaging-Verzeichnis mit dem Namen MyUMWeb erstellt.

New-UMVirtualDirectory -MyUMWeb -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/UMwebservices.aspx"