Set-ClientAccessServer
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Set-ClientAccessServer, um Einstellungen zu ändern, die der Clientzugriffsserverrolle zugeordnet sind.
Hinweis: Verwenden Sie in Exchange 2013 oder höher stattdessen das Cmdlet Set-ClientAccessService. Wenn Sie über Skripts verfügen, die Set-ClientAccessServer verwenden, aktualisieren Sie sie, um Set-ClientAccessService zu verwenden.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Set-ClientAccessServer
[-Identity] <ClientAccessServerIdParameter>
[-AlternateServiceAccountCredential <PSCredential[]>]
[-CleanUpInvalidAlternateServiceAccountCredentials]
[-Confirm]
[-DomainController <Fqdn>]
[-IrmLogEnabled <Boolean>]
[-IrmLogMaxAge <EnhancedTimeSpan>]
[-IrmLogMaxDirectorySize <Unlimited>]
[-IrmLogMaxFileSize <ByteQuantifiedSize>]
[-IrmLogPath <LocalLongFullPath>]
[-IsOutOfService <Boolean>]
[-RemoveAlternateServiceAccountCredentials]
[-WhatIf]
[<CommonParameters>] Set-ClientAccessServer
[-Identity] <ClientAccessServerIdParameter>
[-Array <ClientAccessArrayIdParameter>]
[-AutoDiscoverServiceInternalUri <Uri>]
[-AutoDiscoverSiteScope <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-IrmLogEnabled <Boolean>]
[-IrmLogMaxAge <EnhancedTimeSpan>]
[-IrmLogMaxDirectorySize <Unlimited>]
[-IrmLogMaxFileSize <ByteQuantifiedSize>]
[-IrmLogPath <LocalLongFullPath>]
[-IsOutOfService <Boolean>]
[-WhatIf]
[<CommonParameters>] Beschreibung
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
Set-ClientAccessServer -Identity "MBX-01" -AutoDiscoverServiceInternalUri "https://mbx01.contoso.com/autodiscover/autodiscover.xml" -AutoDiscoverSiteScope "Mail"In diesem Beispiel wird die interne AutoErmittlungs-URL für den Active Directory-Standort mail in den Clientzugriffsdiensten auf dem Server MBX-01 konfiguriert.
Parameter
-AlternateServiceAccountCredential
Der Parameter AlternateServiceAccountCredential gibt einen alternativen Benutzernamen und ein Kennwort für das Dienstkonto an, die normalerweise für die Kerberos-Authentifizierung in Exchange Server 2010-Koexistenzumgebungen verwendet werden. Es können mehrere Werte durch Kommata getrennt angegeben werden.
Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.
| Type: | PSCredential[] |
| 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 |
-Array
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | ClientAccessArrayIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AutoDiscoverServiceInternalUri
Der Parameter AutoDiscoverServiceInternalUri gibt die interne URL des AutoErmittlungsdiensts an.
| Type: | Uri |
| 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 |
-AutoDiscoverSiteScope
Der Parameter AutoDiscoverSiteScope gibt den Active Directory-Standort an, für den der AutoErmittlungsdienst autoritativ ist. Clients, die eine Verbindung zum AutoErmittlungsdienst mithilfe der internen URL herstellen, müssen am angegebenen Standort vorhanden sein.
Verwenden Sie das Cmdlet Get-ADSite, um die verfügbaren Active Directory-Standorte anzuzeigen.
Verwenden Sie die folgende Syntax, um mehrere Werte anzugeben: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| 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 |
-CleanUpInvalidAlternateServiceAccountCredentials
Der CleanUpInvalidAlternateServiceAccountCredentials-Switch gibt an, ob ein zuvor konfiguriertes alternatives Dienstkonto entfernt werden soll, das nicht mehr gültig ist. Sie müssen keinen Wert für diese Option angeben.
| 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 |
-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 |
-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.
| 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 |
-Identity
Der Parameter Identity gibt den Server an, den Sie ändern möchten. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Name
- Distinguished Name (DN)
- FQDN
- GUID
| Type: | ClientAccessServerIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IrmLogEnabled
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter IrmLogEnabled gibt an, ob die Protokollierung für Die Verwaltung von Informationsrechten (IrM) aktiviert ist. Gültige Werte sind $true oder $false. Der Standardwert ist $true.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-IrmLogMaxAge
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter IrmLogMaxAge gibt das maximale Alter für IRM-Protokolle an. Protokolle, die älter als der angegebene Wert sind, werden gelöscht.
Geben Sie einen Wert als Zeitraum an: tt.hh:mm:ss, wobei t = Tage, h = Stunden, m = Minuten und s = Sekunden sind.
Um beispielsweise ein 15-Stunden-Intervall anzugeben, geben Sie 15:00:00 ein. Der Standardwert ist 30 Tage (30.00:00:00).
| Type: | EnhancedTimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-IrmLogMaxDirectorySize
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter IrmLogMaxDirectorySize gibt die maximale Verzeichnisgröße für IRM-Protokolle an. Wenn die maximale Verzeichnisgröße erreicht ist, löscht der Server zuerst die alten Protokolldateien.
Ein gültiger Wert ist eine Zahl von bis zu 909,5 TB (999999999999999 Bytes) oder der Wert unlimited. Der Standardwert beträgt 250 MB (262144000 Bytes).
Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:
- B (Bytes)
- KB (Kilobytes)
- MB (Megabytes)
- GB (Gigabytes)
- TB (Terabytes)
Nicht qualifizierte Werte werden in der Regel als Byte behandelt, kleine Werte werden jedoch auf das nächsthöhere Kilobyte aufgerundet.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-IrmLogMaxFileSize
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter IrmLogMaxFileSize gibt die maximale Größe des IRM-Protokolls an. Dieser Wert darf nicht größer als der IrmLogMaxDirectorySize-Parameterwert sein.
Ein gültiger Wert ist eine Zahl von bis zu 4 Gigabyte (4294967296 Bytes). Der Standardwert beträgt 10 MB (10485760 Bytes).
Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:
- B (Bytes)
- KB (Kilobytes)
- MB (Megabytes)
- GB (Gigabytes)
Nicht qualifizierte Werte werden in der Regel als Byte behandelt, kleine Werte werden jedoch auf das nächsthöhere Kilobyte aufgerundet.
Der Wert dieses Parameters muss kleiner oder gleich dem Wert des Parameters ReceiveProtocolLogMaxDirectorySize sein.
| Type: | ByteQuantifiedSize |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-IrmLogPath
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Parameter IrmLogPath gibt den Speicherort der IRM-Protokolldateien an. Der Standardspeicherort ist %ExchangeInstallPath%Logging\IRMLogs.
| Type: | LocalLongFullPath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-IsOutOfService
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-RemoveAlternateServiceAccountCredentials
Der RemoveAlternateServiceAccountCredentials-Switch gibt an, ob ein zuvor verteiltes alternatives Dienstkonto entfernt werden soll. Sie müssen bei dieser Option keinen Wert angeben.
| 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 |
-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.