Set-UMVirtualDirectory (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2008-05-14
Mit dem Cmdlet Set-UMVirtualDirectory können Sie ein vorhandenes virtuelles Exchange Unified Messaging-Verzeichnis auf einem Computer mit Exchange 2007 ändern, auf dem die Serverfunktion ClientAccess installiert ist.
Syntax
Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WindowsAuthentication <$true | $false>]
Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-InternalUrl <Uri>] [-WindowsAuthentication <$true | $false>]
Detaillierte Beschreibung
Mit dem Cmdlet Set-UMVirtualDirectory können Sie ein vorhandenes virtuelles Verzeichnis der Exchange-Webdienste auf einem Exchange 2007-Clientzugriffsserver ändern.
Damit Sie das Cmdlet Set-UMVirtualDirectory ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Verwenden Sie diesen Parameter, um den Namen des virtuellen Verzeichnisses anzugeben. Anstelle der Standardwebsite kann ebenfalls ein Platzhalterzeichen angegeben werden. |
BasicAuthentication |
Optional |
System.Boolean |
Verwenden Sie diesen Parameter, um anzugeben, ob die Standardauthentifizierung für das virtuelle Verzeichnis der Exchange-Webdienste aktiviert ist. Dieser Parameter kann zusammen mit FormsAuthentication oder mit DigestAuthentication und WindowsAuthentication verwendet werden. |
DigestAuthentication |
Optional |
System.Boolean |
Verwenden Sie diesen Parameter, um anzugeben, ob die Digestauthentifizierung für das virtuelle Verzeichnis aktiviert ist. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Verwenden Sie diesen Parameter zum Festlegen des vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers, der Daten aus dem Active Directory-Verzeichnisdienst abruft. Geben Sie den Parameter DomainController mit dem Cmdlet an. |
ExternalUrl |
Optional |
System.Uri |
Verwenden Sie diesen Parameter, um den Hostnamen anzugeben, der für die Herstellung von Verbindungen zum Clientzugriffsserver von Computern außerhalb der Firewall verwendet wird. Die Einstellung ist auch wichtig, wenn SSL (Secure Sockets Layer) verwendet wird. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADUMVirtualDirectory |
Verwenden Sie diesen Parameter, um dem zu verarbeitenden Cmdlet ein vollständiges Objekt zu übergeben. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an das Cmdlet übergeben werden muss. |
InternalUrl |
Optional |
System.Uri |
Verwenden Sie diesen Parameter, um den Hostnamen des Clientzugriffsservers für Verbindungen anzugeben, die von Computern innerhalb der Firewall hergestellt werden. Die Einstellung ist auch wichtig, wenn SSL verwendet wird. |
WindowsAuthentication |
Optional |
System.Boolean |
Verwenden Sie diesen Parameter, um anzugeben, ob die integrierte Windows-Authentifizierung für das virtuelle Unified Messaging-Verzeichnis zulässig ist. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Im ersten Codebeispiel wird die Digestauthentifizierung als Authentifizierungsmethode für das virtuelle Verzeichnis UnifiedMessaging auf dem Server UMserver1 festgelegt. Darüber hinaus werden die externen und internen URLs für dieses virtuelle Verzeichnis festgelegt.
Im zweiten Codebeispiel wird anstelle der Standardwebsite ein Platzhalterzeichen verwendet.
Set-UMVirtualDirectory -Identity UMServer1\UnifiedMessaging -ExternalUrl https://www.contoso.com/UnifiedMessaging/service.asmx -ExternalAuthenticationMethods Digest -InternalUrl https://contoso.internal.com/UnifiedMessaging/service.asmx
Set-UMVirtualDirectory -Identity UMServer1\UnifiedMessaging* -ExternalUrl https://www.contoso.com/UnifiedMessaging/service.asmx