Set-ClientAccessServer

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet Set-ClientAccessServer per modificare le impostazioni associate al ruolo del server Accesso client.

Nota: in Exchange 2013 o versioni successive, usare invece il cmdlet Set-ClientAccessService. Se disponi di script che usano Set-ClientAccessServer, aggiornali per usare Set-ClientAccessService.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

AlternateServiceAccount 

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>]

Identity 

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>]

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-ClientAccessServer -Identity "MBX-01" -AutoDiscoverServiceInternalUri "https://mbx01.contoso.com/autodiscover/autodiscover.xml" -AutoDiscoverSiteScope "Mail"

In questo esempio viene configurato l'URL di individuazione automatica interno per il sito di Active Directory denominato Mail nei servizi di accesso client nel server denominato MBX-01.

Parametri

-AlternateServiceAccountCredential

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro AlternateServiceAccountCredential consente di specificare un nome utente e una password dell'account di servizio alternativi che vengono in genere utilizzati per l'autenticazione Kerberos negli ambienti di coesistenza di Exchange Server 2010. È possibile specificare più valori separati da virgole.

Un valore per questo parametro richiede il cmdlet Get-Credential. Per sospendere questo comando e visualizzare la richiesta di immissione delle credenziali, usare il valore (Get-Credential). In alternativa, prima di eseguire questo comando, archiviare le credenziali in una variabile (ad esempio, $cred = Get-Credential) e quindi usare il nome della variabile ($cred) per questo parametro. Per altre informazioni, vedere Get-Credential.

Proprietà dei parametri

Tipo:

PSCredential[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AlternateServiceAccount
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Array

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:ClientAccessArrayIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AutoDiscoverServiceInternalUri

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro AutoDiscoverServiceInternalUri consente di specificare l'URL interno per il servizio di individuazione automatica.

Proprietà dei parametri

Tipo:Uri
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AutoDiscoverSiteScope

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro AutoDiscoverSiteScope consente di specificare il sito di Active Directory per cui il servizio di individuazione automatica è autorevole. I client che si connettono al servizio di individuazione automatica utilizzando l'URL interno devono trovarsi nel sito specificato.

Per visualizzare i siti di Active Directory disponibili, usare il cmdlet Get-ADSite.

Per specificare più valori, utilizzare la sintassi seguente: Value1,Value2,...ValueN. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CleanUpInvalidAlternateServiceAccountCredentials

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione CleanUpInvalidAlternateServiceAccountCredentials consente di specificare se rimuovere un account di servizio alternativo precedentemente configurato che non è più valido. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AlternateServiceAccount
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DomainController

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro Identity consente di specificare il server che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • FQDN
  • GUID

Proprietà dei parametri

Tipo:ClientAccessServerIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-IrmLogEnabled

Applicabile: Exchange Server 2010

Il parametro IrmLogEnabled consente di specificare se è abilitata la registrazione per Information Rights Management (IRM). I valori validi sono $true o $false. Il valore predefinito è $true.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogMaxAge

Applicabile: Exchange Server 2010

Il parametro IrmLogMaxAge consente di specificare l'età massima per i registri IRM. I log precedenti al valore specificato vengono eliminati.

Per specificare un valore, immetterlo come intervallo di tempo: gg.hh:mm:ss dove g = giorni, h = ore, m = minuti e s = secondi.

Ad esempio, per specificare un intervallo di 15 ore, immettere 15:00:00. Il valore predefinito è 30 giorni (30.00:00:00).

Proprietà dei parametri

Tipo:EnhancedTimeSpan
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogMaxDirectorySize

Applicabile: Exchange Server 2010

Il parametro IrmLogMaxDirectorySize consente di specificare la dimensione massima della directory per i registri IRM. Quando viene raggiunta la dimensione massima della directory, il server elimina prima i vecchi file di registro.

Un valore valido è un numero fino a 909,5 terabyte (999999999999999 byte) o il valore unlimited. Il valore predefinito è 250 megabyte (262144000 byte).

Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:

  • B (byte)
  • KB (kilobyte)
  • MB (megabyte)
  • GB (gigabyte)
  • TB (terabyte)

I valori non qualificati vengono in genere trattati come byte, ma i valori piccoli possono essere arrotondati per eccesso al kilobyte più vicino.

Proprietà dei parametri

Tipo:Unlimited
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogMaxFileSize

Applicabile: Exchange Server 2010

Il parametro IrmLogMaxFileSize consente di specificare la dimensione massima del registro IRM. Questo valore non può essere maggiore del valore del parametro IrmLogMaxDirectorySize.

Un valore valido è un numero massimo di 4 gigabyte (4294967296 byte). Il valore predefinito è 10 megabyte (10485760 byte).

Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:

  • B (byte)
  • KB (kilobyte)
  • MB (megabyte)
  • GB (gigabyte)

I valori non qualificati vengono in genere trattati come byte, ma i valori piccoli possono essere arrotondati per eccesso al kilobyte più vicino.

È necessario che il valore di questo parametro sia inferiore o uguale al valore del parametro ReceiveProtocolLogMaxDirectorySize.

Proprietà dei parametri

Tipo:ByteQuantifiedSize
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogPath

Applicabile: Exchange Server 2010

Il parametro IrmLogPath consente di specificare il percorso dei file di log IRM. La posizione predefinita è %ExchangeInstallPath%Logging\IRMLogs.

Se si imposta il valore del parametro su $null, la registrazione IRM viene disabilitata. Tuttavia, se il valore del parametro IrmLogEnabled è $true, Exchange aggiunge errori al registro eventi dell'applicazione. La modalità da preferire per la disabilitazione della registrazione IRM è l'impostazione del parametro IrmLogEnabled su $false.

Proprietà dei parametri

Tipo:LocalLongFullPath
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IsOutOfService

Applicabile: Exchange Server 2010

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RemoveAlternateServiceAccountCredentials

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione RemoveAlternateServiceAccountCredentials consente di specificare se rimuovere un account di servizio alternativo precedentemente distribuito. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AlternateServiceAccount
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.