Set-UMVirtualDirectory
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2008-11-10
Verwenden Sie das Cmdlet Set-UMVirtualDirectory, um ein vorhandenes virtuelles Exchange Unified Messaging-Verzeichnis auf einem Computer mit Exchange 2007 zu ändern, auf dem die Serverfunktion ClientAccess installiert ist.
Syntax
Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-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 dem verwendeten Konto die Rolle Exchange-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 |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Dieser Parameter gibt den Namen des virtuellen Verzeichnisses an. Anstelle der Standardwebsite kann ebenfalls ein Platzhalterzeichen angegeben werden. |
BasicAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Standardauthentifizierung für das virtuelle Verzeichnis der Exchange-Webdienste aktiviert ist. Dieser Parameter kann zusammen mit den Parametern FormsAuthentication oder mit DigestAuthentication und WindowsAuthentication verwendet werden. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter bewirkt, dass der Befehl die Verarbeitung unterbricht. Der Administrator muss die weitere Aktion des Befehls bestätigen, bevor die Verarbeitung fortgesetzt werden kann. Der Standardwert ist |
DigestAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die Digestauthentifizierung für das virtuelle Verzeichnis aktiviert ist. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Dieser Parameter gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers an, der Daten aus dem Active Directory-Verzeichnisdienst abruft. Geben Sie den Parameter DomainController mit dem Cmdlet an. |
ExternalUrl |
Optional |
System.Uri |
Dieser Parameter legt den Hostnamen fest, der verwendet wird, um von außerhalb der Firewall eine Verbindung mit dem Clientzugriffsserver herzustellen. Die Einstellung ist auch wichtig, wenn SSL (Secure Sockets Layer) verwendet wird. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADUMVirtualDirectory |
Dieser Parameter gibt an, ob dem zu verarbeitenden Cmdlet ein vollständiges Objekt übergeben wird. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an das Cmdlet übergeben werden muss. |
InternalUrl |
Optional |
System.Uri |
Dieser Parameter legt den Hostnamen des Clientzugriffsservers für die Verbindung von innerhalb der Firewall fest. Die Einstellung ist wichtig, wenn SSL verwendet wird. |
WindowsAuthentication |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob die integrierte Windows-Authentifizierung für das virtuelle Unified Messaging-Verzeichnis zulässig 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. Ein Administrator kann den Parameter WhatIf verwenden, um die sich ergebenden Änderungen anzuzeigen, ohne diese Änderungen tatsächlich auszuführen. Der Standardwert 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 namens UMserver1 festgelegt. Darüber hinaus werden die externen und internen URLs für dieses virtuelle Verzeichnis festgelegt.
Im zweiten Codebeispiel wird anstelle von "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