Freigeben über


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.