Set-ClientAccessServer
Questo cmdlet è disponibile solo in Exchange locale.
Usare 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 sono presenti script che usano Set-ClientAccessServer, aggiornarli in modo da usare Set-ClientAccessService.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
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>]
Descrizione
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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
Il parametro AlternateServiceAccountCredential consente di specificare un nome utente e una password dell'account di servizio alternativi usati in genere per l'autenticazione Kerberos negli ambienti di coesistenza 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.
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
Questo parametro è riservato all'uso interno da parte di Microsoft.
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
Il parametro AutoDiscoverServiceInternalUri consente di specificare l'URL interno per il servizio di individuazione automatica.
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
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, usare la sintassi seguente: Value1,Value2,...ValueN
. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "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
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.
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
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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
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.
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
Il parametro Identity consente di specificare il server da modificare. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- Nome
- Nome distinto (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
Questo parametro è disponibile solo in Exchange Server 2010.
Il parametro IrmLogEnabled specifica se la registrazione è abilitata per Information Rights Management (IRM). I valori validi sono $true o $false. Il valore predefinito è $true.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IrmLogMaxAge
Questo parametro è disponibile solo in Exchange Server 2010.
Il parametro IrmLogMaxAge specifica la validità massima per i log 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).
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IrmLogMaxDirectorySize
Questo parametro è disponibile solo in Exchange Server 2010.
Il parametro IrmLogMaxDirectorySize specifica le dimensioni massime della directory per i log IRM. Quando viene raggiunta la dimensione massima della directory, il server elimina prima i file di log precedenti.
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)
TB (terabyte)
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IrmLogMaxFileSize
Questo parametro è disponibile solo in Exchange Server 2010.
Il parametro IrmLogMaxFileSize specifica le dimensioni massime del log IRM. Questo valore non può essere maggiore del valore del parametro IrmLogMaxDirectorySize.
Un valore valido è un numero fino a 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)
TB (terabyte)
È necessario che il valore di questo parametro sia inferiore o uguale al valore del parametro ReceiveProtocolLogMaxDirectorySize.
Type: | ByteQuantifiedSize |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IrmLogPath
Questo parametro è disponibile solo in Exchange Server 2010.
Il parametro IrmLogPath specifica il percorso dei file di log IRM. La posizione predefinita è %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
Questo parametro è disponibile solo in Exchange Server 2010.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RemoveAlternateServiceAccountCredentials
L'opzione RemoveAlternateServiceAccountCredentials consente di specificare se rimuovere un account di servizio alternativo precedentemente distribuito. Con questa opzione non è necessario specificare alcun valore.
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
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
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 |
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.