Set-AutodiscoverVirtualDirectory

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet Set-AutodiscoverVirtualDirectory per configurare le directory virtuali di individuazione automatica utilizzate in Internet Information Services (IIS) Exchange server.

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

Sintassi

Set-AutodiscoverVirtualDirectory
   [-Identity] <VirtualDirectoryIdParameter>
   [-BasicAuthentication <Boolean>]
   [-Confirm]
   [-DigestAuthentication <Boolean>]
   [-DomainController <Fqdn>]
   [-ExtendedProtectionFlags <MultiValuedProperty>]
   [-ExtendedProtectionSPNList <MultiValuedProperty>]
   [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
   [-ExternalUrl <Uri>]
   [-InternalUrl <Uri>]
   [-OAuthAuthentication <Boolean>]
   [-WhatIf]
   [-WindowsAuthentication <Boolean>]
   [-WSSecurityAuthentication <Boolean>]
   [<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-AutodiscoverVirtualDirectory -Identity 'Autodiscover(Default Web Site)' -WindowsAuthentication $false -BasicAuthentication $false -DigestAuthentication $true

In questo esempio viene impostato il metodo di autenticazione sull'autenticazione del digest per la directory virtuale di individuazione automatica.

Esempio 2

Set-AutodiscoverVirtualDirectory -Identity 'autodiscover (default Web site)' -ExternalUrl 'https://www.contoso.com'

In Exchange Server 2010, questo esempio imposta l'URL esterno per la directory virtuale Autodiscover.

Esempio 3

Set-AutodiscoverVirtualDirectory -Identity 'Autodiscover (Default Web Site)' -WindowsAuthentication $true

In questo esempio viene impostata l'Windows integrata per la directory virtuale Autodiscover.

Parametri

-BasicAuthentication

Il parametro BasicAuthentication consente di specificare se l'autenticazione di base è abilitata nella directory virtuale. I valori validi sono:

  • $true: l'autenticazione di base è abilitata. Questo è il valore predefinito.
  • $true: l'autenticazione di base è abilitata. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
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-*) 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, 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-DigestAuthentication

Il parametro DigestAuthentication consente di specificare se l'autenticazione del digest è abilitata nella directory virtuale. I valori validi sono:

  • $true: l'autenticazione del digest è abilitata.
  • $true: l'autenticazione del digest è abilitata.
Type:Boolean
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExtendedProtectionFlags

Il parametro ExtendedProtectionFlags consente di specificare le impostazioni personalizzate per la protezione estesa per l'autenticazione nella directory virtuale. I valori validi sono:

  • Nessuno: impostazione predefinita.
  • AllowDotlessSPN: obbligatorio se si desidera utilizzare i valori del nome dell'entità servizio (SPN) che non contengono FQDN (ad esempio, HTTP/ContosoMail anziché HTTP/mail.contoso.com). I nomi SPN vengono specificati con il parametro ExtendedProtectionSPNList. Questa impostazione rende la protezione estesa per l'autenticazione meno sicura perché i certificati senza punti non sono univoci, quindi non è possibile verificare che la connessione da client a proxy sia stata stabilita su un canale sicuro.
  • NoServiceNameCheck: l'elenco SPN non viene controllato per convalidare un token di binding di canale. Questa impostazione rende la protezione estesa per l'autenticazione meno sicura. Questa impostazione in genere non è consigliata.
  • Proxy: un server proxy è responsabile della terminazione del canale SSL. Per utilizzare questa impostazione, è necessario registrare un SPN utilizzando il parametro ExtendedProtectionSPNList.
  • ProxyCoHosting: il traffico HTTP e HTTPS può accedere alla directory virtuale e un server proxy si trova tra almeno alcuni client e i servizi Accesso client sul server Exchange.
Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExtendedProtectionSPNList

Il parametro ExtendedProtectionSPNList consente di specificare un elenco di nomi dell'entità servizio (SPN) validi se si utilizza la protezione estesa per l'autenticazione nella directory virtuale. I valori validi sono:

  • $null: questo è il valore predefinito.
  • SPN singolo o elenco delimitato da virgole di nomi SPN validi: il formato del valore SPN è Protocol\FQDN . Ad esempio, HTTP/mail.contoso.com. Per aggiungere un nome SPN diverso da un nome di dominio completo (ad esempio, HTTP/ContosoMail), è inoltre necessario utilizzare il valore AllowDotlessSPN per il parametro ExtendedProtectionFlags.
Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExtendedProtectionTokenChecking

Il parametro ExtendedProtectionTokenChecking consente di definire la modalità di utilizzo della protezione estesa per l'autenticazione nella directory virtuale. Per impostazione predefinita, la protezione estesa per l'autenticazione non è abilitata. I valori validi sono:

  • Nessuno: la protezione estesa per l'autenticazione non viene utilizzata nella directory virtuale. Questo è il valore predefinito.
  • None: la protezione estesa per l'autenticazione non viene utilizzata sulla directory virtuale. Questo è il valore predefinito.
  • Richiedi: la protezione estesa per l'autenticazione viene utilizzata per tutte le connessioni tra client e la directory virtuale. Se il client o il server non lo supporta, la connessione avrà esito negativo. Se si utilizza questo valore, è inoltre necessario impostare un valore SPN per il parametro ExtendedProtectionSPNList.

Nota: se si utilizza il valore Allow o Require e si dispone di un server proxy tra il client e i servizi Accesso client sul server Cassette postali configurato per terminare il canale SSL da client a proxy, è inoltre necessario configurare uno o più nomi dell'entità servizio (SPN) utilizzando il parametro ExtendedProtectionSPNList.

Type:ExtendedProtectionTokenCheckingMode
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExternalUrl

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro ExternalUrl consente di specificare l'URL utilizzato per connettersi alla directory virtuale dall'esterno del firewall di rete.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-Identity

Il parametro Identity consente di specificare la directory virtuale di individuazione automatica che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi la directory virtuale in modo univoco. Ad esempio:

  • Nome o nome \ server
  • Nome distinto (DN)
  • GUID

Il valore Name utilizza la "VirtualDirectoryName (WebsiteName)" sintassi delle proprietà della directory virtuale. È possibile specificare il carattere jolly ( * ) anziché il sito Web predefinito utilizzando la sintassi VirtualDirectoryName* .

Type:VirtualDirectoryIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-InternalUrl

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro InternalUrl consente di specificare l'URL utilizzato per connettersi alla directory virtuale dall'interno del firewall di rete.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-OAuthAuthentication

È possibile specificare più valori separati da virgole.

  • $true: l'autenticazione OAuth è abilitata. Questo è il valore predefinito.
  • $false: l'autenticazione OAuth è disabilitata.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-WindowsAuthentication

Il parametro WindowsAuthentication consente di specificare se l'autenticazione Windows integrata è abilitata nella directory virtuale. I valori validi sono:

  • $true: l'autenticazione Windows integrata è abilitata. Questo è il valore predefinito.
  • $false: l'autenticazione Windows integrata è disabilitata.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-WSSecurityAuthentication

Il parametro WSSecurityAuthentication consente di specificare se l'autenticazione WS-Security (sicurezza dei servizi Web) è abilitata nella directory virtuale. I valori validi sono:

  • $true: WS-Security'autenticazione è abilitata. Questo è il valore predefinito.
  • $true: l'autenticazione WS-Security è abilitata. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Input

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

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.