Set-WebServicesVirtualDirectory
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Set-WebServicesVirtualDirectory per modificare le directory virtuali di Servizi Web Exchange esistenti utilizzate in Internet Information Services (IIS) sui server Microsoft Exchange.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Set-WebServicesVirtualDirectory
[-Identity] <VirtualDirectoryIdParameter>
[-BasicAuthentication <Boolean>]
[-CertificateAuthentication <Boolean>]
[-Confirm]
[-DigestAuthentication <Boolean>]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalUrl <Uri>]
[-Force]
[-GzipLevel <GzipLevel>]
[-InternalNLBBypassUrl <Uri>]
[-InternalUrl <Uri>]
[-MRSProxyEnabled <Boolean>]
[-MRSProxyMaxConnections <Unlimited>]
[-OAuthAuthentication <Boolean>]
[-WhatIf]
[-WindowsAuthentication <Boolean>]
[-WSSecurityAuthentication <Boolean>]
[<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-WebServicesVirtualDirectory -Identity Contoso\EWS(Default Web Site) -ExternalUrl https://www.contoso.com/EWS/exchange.asmx -BasicAuthentication $true -InternalUrl https://contoso.internal.com/EWS/exchange.asmx
In questo esempio viene impostato il metodo di autenticazione su Di base per la directory virtuale EWS nel server Contoso. In questo esempio vengono impostati anche l'URL esterno e interno della directory virtuale.
Esempio 2
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/EWS/exchange.asmx
In questo esempio viene utilizzato un carattere jolly al posto di "Sito Web predefinito", utilizzato nell'esempio 1.
Esempio 3
Set-WebServicesVirtualDirectory -Identity "EWS (Default Web Site)" -MRSProxyEnabled $true
In questo esempio viene abilitato MRSProxy sul sito Web predefinito EWS. MRSProxy è il servizio che supporta gli spostamenti delle cassette postali remote.
Parametri
-BasicAuthentication
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro BasicAuthentication consente di specificare se è abilitata l'autenticazione di base 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.
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 |
-CertificateAuthentication
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro CertificateAuthentication consente di specificare se l'autenticazione dei certificati è abilitata. Questo parametro influisce sulla <Servername>/ews/management/ directory virtuale. Non influisce sulla <Servername>/ews/ directory virtuale.
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 |
-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 |
-DigestAuthentication
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro DigestAuthentication consente di specificare se l'autenticazione Digest è abilitata nella directory virtuale. I valori validi sono:
- $true: l'autenticazione digest è abilitata.
- $false: l'autenticazione del digest è disabilitata. Questo è il valore predefinito.
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 |
-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 |
-ExtendedProtectionFlags
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 vogliono usare valori SPN (Service Principal Name) 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 punto non sono univoci, quindi non è possibile garantire 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 associazione di canale. Questa impostazione rende meno sicura la protezione estesa per l'autenticazione. In genere non è consigliabile usare questa impostazione.
- Proxy: un server proxy è responsabile della chiusura del canale TLS. Per usare questa impostazione, è necessario registrare un nome SPN usando il parametro ExtendedProtectionSPNList.
- ProxyCoHosting: è possibile che il traffico HTTP e HTTPS acceda alla directory virtuale e che un server proxy si trovi tra almeno alcuni dei client e i servizi Accesso client nel server Exchange.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| 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 |
-ExtendedProtectionSPNList
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro ExtendedProtectionSPNList consente di specificare un elenco di nomi di entità servizio (SPN) validi se si usa la protezione estesa per l'autenticazione nella directory virtuale. I valori validi sono:
- $null: questo è il valore predefinito.
- Elenco SPN singolo o delimitato da virgole di SPN validi: il formato del valore SPN è
Protocol\FQDN. Ad esempio, HTTP/mail.contoso.com. Per aggiungere un nome SPN che non è un FQDN (ad esempio, HTTP/ContosoMail), è anche necessario usare il valore AllowDotlessSPN per il parametro ExtendedProtectionFlags.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| 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 |
-ExtendedProtectionTokenChecking
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro ExtendedProtectionTokenChecking consente di specificare se la protezione estesa per l'autenticazione viene utilizzata per le connessioni client alla directory virtuale. I valori validi sono:
- Nessuno: la protezione estesa per l'autenticazione non viene usata per le connessioni client alla directory virtuale. Questo è il valore predefinito.
- Consenti: la protezione estesa per l'autenticazione viene utilizzata per le connessioni client alla directory virtuale, se sia il client che il server la supportano.
- Richiedi: la protezione estesa per l'autenticazione è necessaria per le connessioni client alla directory virtuale. Se il client o il server non lo supporta, la connessione avrà esito negativo. Questo valore richiede anche un valore SPN (Service Principal Name) per il parametro ExtendedProtectionSPNList.
Nota: se un server proxy davanti al server Exchange termina il canale TLS (Transport Layer Security) da client a proxy, i valori Consenti o Richiede richiedono uno o più valori SPN per il parametro ExtendedProtectionSPNList.
Proprietà dei parametri
| Tipo: | ExtendedProtectionTokenCheckingMode |
| 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 |
-ExternalUrl
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro ExternalURL consente di specificare l'URL che si connette alla directory virtuale dall'esterno del firewall.
Il valore di questo parametro è importante quando le connessioni vengono crittografate da TLS (Transport Layer Security).
Proprietà dei parametri
| Tipo: | Uri |
| 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 |
-Force
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
L'interruttore di forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| 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 |
-GzipLevel
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro GzipLevel consente di impostare la configurazione Gzip per la directory virtuale di Servizi Web Exchange. I valori validi sono:
- Disattivato: nessuna compressione.
- Basso: solo compressione statica. Questo è il valore predefinito. Questo valore ha lo stesso risultato del valore Off, perché il contenuto dei Servizi Web Exchange è dinamico.
- Alta: compressione statica e dinamica. Il contenuto dei servizi Web Exchange viene compresso se i client indicano il supporto per la compressione Gzip nelle loro richieste.
- Errore: identifica gli errori nella configurazione della compressione Gzip.
Proprietà dei parametri
| Tipo: | GzipLevel |
| 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 la directory virtuale EWS che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi la directory virtuale in modo univoco. Ad esempio:
- Nome o Server\Nome
- Nome distinto (DN)
- GUID
Il valore Name utilizza la sintassi "VirtualDirectoryName (WebsiteName)" delle proprietà della directory virtuale. È possibile specificare il carattere jolly (*) anziché il sito Web predefinito utilizzando la sintassi VirtualDirectoryName*.
Proprietà dei parametri
| Tipo: | VirtualDirectoryIdParameter |
| 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 |
-InternalNLBBypassUrl
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Nota: Questo parametro si applica solo a Exchange 2010. Per impostazione predefinita, Exchange 2013 o versione successiva ha già il valore InternalNLBBypassUrl configurato nella directory virtuale back-end Servizi Web Exchange (EWS) nei server Cassette postali.
Il parametro InternalNLBBypassUrl consente di specificare l'URL del server Exchange in cui è installato il ruolo del server Accesso client, indipendentemente dal fatto che si trovi o meno dietro una matrice di bilanciamento del carico di rete.
Quando si imposta il parametro InternalUrl sull'URL relativo alla matrice del bilanciamento del carico di rete, è necessario impostare il parametro InternalNLBBypassUrl sull'URL del server Accesso Client stesso.
Proprietà dei parametri
| Tipo: | Uri |
| 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 |
-InternalUrl
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro InternalURL consente di specificare l'URL che si connette alla directory virtuale dall'interno del firewall.
Il valore di questo parametro è importante quando le connessioni vengono crittografate da TLS (Transport Layer Security).
Proprietà dei parametri
| Tipo: | Uri |
| 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 |
-MRSProxyEnabled
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro MRSProxyEnabled consente di specificare se abilitare MRSProxy per la directory virtuale di Servizi Web Exchange sui server Exchange in cui è installato il ruolo del server Accesso client. MRSProxy consente di spostare le cassette postali proxy tra le foreste di Active Directory. Il valore predefinito è $false.
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 |
-MRSProxyMaxConnections
Applicabile: Exchange Server 2010
Il parametro MRSProxyMaxConnections consente di specificare il numero massimo di sessioni di spostamento simultanee accettate da un'istanza di MRSProxy. Questa impostazione accetta valori da 0 a illimitato. Il valore predefinito è 100. Per ulteriori informazioni su MRSProxy, vedere Informazioni sulle richieste di spostamento.
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 |
-OAuthAuthentication
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro OAuthAuthentication consente di specificare se è abilitata l'autenticazione OAuth nella directory virtuale. I valori validi sono:
- $true: l'autenticazione OAuth è abilitata. Questo è il valore predefinito.
- $false: l'autenticazione OAuth è disabilitata.
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 |
-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 |
-WindowsAuthentication
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro WindowsAuthentication consente di specificare se è abilitata l'autenticazione di Windows integrata nella directory virtuale. I valori validi sono:
- $true: Il autenticazione di Windows integrato è abilitato. Questo è il valore predefinito.
- $false: la autenticazione di Windows integrata è disabilitata.
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 |
-WSSecurityAuthentication
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro WSSecurityAuthentication consente di specificare se è abilitata l'autenticazione WS-Security (Web Services Security) 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.
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 |
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.