New-WebServicesVirtualDirectory
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet New-WebServicesVirtualDirectory per creare directory virtuali di Servizi Web Exchange usate in Internet Information Services (IIS) nei server Exchange Microsoft.
Mediante questo cmdlet, è possibile creare più directory virtuali. È tuttavia possibile creare una sola directory virtuale di Servizi Web Exchange per ogni sito Web.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-WebServicesVirtualDirectory
[-ApplicationRoot <String>]
[-AppPoolId <String>]
[-AppPoolIdForManagement <String>]
[-BasicAuthentication <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>]
[-Path <String>]
[-Role <VirtualDirectoryRole>]
[-Server <ServerIdParameter>]
[-WebSiteName <String>]
[-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
New-WebServicesVirtualDirectory -WebSiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"In questo esempio viene creata una directory virtuale nella www.contoso.com del sito Web non predefinita. Imposta anche l'URL esterno su https://www.contoso.com/webservices.aspx.
Parametri
-ApplicationRoot
Il parametro ApplicationRoot consente di specificare il percorso del metabase della directory virtuale. Per impostazione predefinita, il percorso è lo stesso del sito Web in cui viene creata la directory virtuale.
| Type: | String |
| 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 |
-AppPoolId
Il parametro AppPoolId consente di specificare il pool di applicazioni di Internet Information Services (IIS) in cui viene eseguita la directory virtuale. È consigliabile utilizzare le impostazioni predefinite del parametro.
| Type: | String |
| 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 |
-AppPoolIdForManagement
Il parametro AppPoolIdForManagement consente di specificare il pool di programmi che gestisce la directory virtuale.
| Type: | String |
| 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 |
-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 |
| 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 |
-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.
- $false: l'autenticazione del digest è disabilitata. Questo è il valore predefinito.
| Type: | Boolean |
| 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 |
-ExtendedProtectionFlags
Il parametro ExtendedProtectionFlags consente di specificare 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). Specificare i nomi SPN con il parametro ExtendedProtectionSPNList. Questa impostazione rende la protezione estesa per l'autenticazione meno sicura perché i certificati dotless 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 la protezione estesa per l'autenticazione meno sicura. In genere questa impostazione non è consigliata.
- Proxy: un server proxy è responsabile della terminazione del canale SSL. Per usare questa impostazione, è necessario registrare un nome SPN usando 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 nel server Exchange.
| 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 |
-ExtendedProtectionSPNList
Il parametro ExtendedProtectionSPNList specifica 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: 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 che non è un nome di dominio completo (ad esempio, HTTP/ContosoMail), è anche necessario usare il valore AllowDotlessSPN per il parametro ExtendedProtectionFlags.
| 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 |
-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 usata 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 usata per tutte le connessioni tra i client e la directory virtuale. Se il client o il server non lo supporta, la connessione avrà esito negativo. Se si usa questo valore, è anche necessario impostare un valore SPN per il parametro ExtendedProtectionSPNList.
Nota: se si usa il valore Allow o Require e si dispone di un server proxy tra il client e i servizi accesso client nel server Cassette postali configurato per terminare il canale SSL da client a proxy, è anche necessario configurare uno o più nomi di entità servizio (SPN) usando il parametro ExtendedProtectionSPNList.
| Type: | ExtendedProtectionTokenCheckingMode |
| 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 |
-ExternalUrl
Il parametro ExternalURL consente di specificare l'URL utilizzato per connettersi alla directory virtuale dall'esterno del firewall.
Tale impostazione è importante anche quando si utilizza Secure Sockets Layer (SSL).
| 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 |
-Force
L'opzione 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.
| 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 |
-GzipLevel
Il parametro GzipLevel imposta la configurazione Gzip per la directory virtuale di Servizi Web Exchange. I valori validi sono:
- Disattivato: nessuna compressione.
- Bassa: solo compressione statica. Questo è il valore predefinito. Questo valore ha lo stesso risultato del valore Off, perché il contenuto di Servizi Web Exchange è dinamico.
- Alta: compressione statica e dinamica. Il contenuto di Servizi Web Exchange viene compresso se i client indicano il supporto per la compressione Gzip nelle richieste.
- Errore: identifica gli errori nella configurazione di compressione Gzip.
| Type: | GzipLevel |
| 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 |
-InternalNLBBypassUrl
Il parametro InternalNLBBypassUrl specifica 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.
| 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 |
-InternalUrl
Il parametro InternalURL consente di specificare l'URL utilizzato per connettersi alla directory virtuale dall'interno del firewall.
Tale impostazione è importante quando si utilizza SSL.
| 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 |
-MRSProxyEnabled
Il parametro MRSProxyEnabled consente di specificare se abilitare MRSProxy per il server Cassette postali. MRSProxy è un servizio eseguito sui server Cassette postali in una foresta remota che consente di inviare tramite proxy la richiesta di spostamento di una cassetta postale. Per altre informazioni, vedere Spostamenti di cassette postali in Exchange Server.
| Type: | Boolean |
| 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 |
-MRSProxyMaxConnections
Questo parametro è disponibile solo in Exchange Server 2010.
Il parametro MRSProxyMaxConnections specifica il numero massimo di sessioni di spostamento simultanee che un'istanza di MRSProxy accetterà. Questa impostazione accetta valori da 0 a illimitato. Il valore predefinito è 100. Per altre informazioni su MRSProxy, vedere Informazioni sulle richieste di spostamento.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-OAuthAuthentication
Il parametro OAuthAuthentication consente di specificare se l'autenticazione OAuth è abilitata nella directory virtuale. I valori validi sono:
- $true: l'autenticazione OAuth è abilitata. Questo è il valore predefinito.
- $false: l'autenticazione OAuth è disabilitata.
| Type: | Boolean |
| 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 |
-Path
Il parametro Path consente di impostare il percorso della directory virtuale nella metabase.
| Type: | String |
| 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 |
-Role
È possibile utilizzare questo URL per esporre dettagli relativi ai criteri di mantenimento in generale. I valori validi sono:
- ClientAccess: configurare la directory virtuale per i servizi accesso client (front-end) nel server Cassette postali.
- Cassetta postale: configurare la directory virtuale per i servizi back-end nel server Cassette postali.
Le connessioni client vengono sottoposte a proxy dai servizi Accesso client ai servizi back-end nei server Cassette postali locali o remoti. I client non si connettono direttamente ai servizi back-end.
| Type: | VirtualDirectoryRole |
| 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 |
-Server
Il parametro Server specifica il server Exchange che ospita la directory virtuale. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- Nome
- FQDN
- Nome distinto (DN)
- ExchangeLegacyDN
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WebSiteName
Il parametro WebSiteName consente di specificare il nome del sito Web all'interno del quale creare la directory virtuale. Questo parametro non deve essere utilizzato durante la creazione di una directory virtuale all'interno del sito Web predefinito.
| Type: | String |
| 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 |
-WindowsAuthentication
Il parametro WindowsAuthentication consente di specificare se la autenticazione di Windows integrata è abilitata nella directory virtuale. I valori validi sono:
- $true: è abilitata la autenticazione di Windows integrata. Questo è il valore predefinito.
- $false: la autenticazione di Windows integrata è disabilitata.
| Type: | Boolean |
| 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 |
-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: l'autenticazione WS-Security è abilitata. Questo è il valore predefinito.
- $true: l'autenticazione WS-Security è abilitata. Questo è il valore predefinito.
| Type: | Boolean |
| 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.