New-EcpVirtualDirectory

Modulo:: Exchange PowerShell

Questo cmdlet è disponibile solo in Exchange locale.

Usare il cmdlet New-EcpVirtualDirectory per creare directory virtuali di Exchange Pannello di controllo (ECP) usate in Internet Information Services (IIS) nei server di Microsoft Exchange. Si tratta di un comando che Microsoft Exchange Server programma di installazione viene eseguito quando si installa Exchange nell'organizzazione. La directory virtuale ECP gestisce l'interfaccia di amministrazione di Exchange.

L'interfaccia di gestione Web ECP è stata introdotta nel Exchange Server 2010. In Exchange Server 2013 e Exchange Server 2016, le directory virtuali di EAC e i cmdlet di gestione corrispondenti usano ancora ECP nel nome. È possibile usare questi cmdlet per gestire le directory virtuali ECP nei server Exchange 2010, Exchange 2013 ed Exchange 2016.

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

Sintassi

Default (Impostazione predefinita)

New-EcpVirtualDirectory
    [-AppPoolId <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalUrl <Uri>]
    [-InternalUrl <Uri>]
    [-Path <String>]
    [-Role <VirtualDirectoryRole>]
    [-Server <ServerIdParameter>]
    [-WebSiteName <String>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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-EcpVirtualDirectory -Server SERVER01 -ExternalURL https://mail.contoso.com/ecp -InternalURL https://mail.contoso.com/ecp

In questo esempio viene creata la directory virtuale ECP nel server Exchange denominato Server01.

Parametri

-AppPoolId

Il parametro AppPoolId consente di impostare il pool di applicazioni di Internet Information Services (IIS) in cui viene eseguita la directory virtuale del Pannello di controllo di Exchange. È consigliabile utilizzare le impostazioni predefinite del parametro.

Proprietà dei parametri

Tipo:	String
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

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet dipende dal fatto che il cmdlet richieda la 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 Conferma senza un valore, viene introdotta una sospensione 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

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

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 TLS. Per usare questa impostazione, è necessario registrare un nome SPN usando il parametro ExtendedProtectionSPNList.
ProxyCoHosting: il traffico HTTP e HTTPS potrebbe accedere alla directory virtuale e un server proxy si trova tra almeno alcuni 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

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: questo valore è 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 che non è un nome di dominio completo (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

Il parametro ExtendedProtectionTokenChecking specifica se la protezione estesa per l'autenticazione viene usata 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 valore è il valore predefinito.
Consenti: la protezione estesa per l'autenticazione viene usata per le connessioni client alla directory virtuale se il client e il server lo supportano entrambi.
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 non riesce. 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 Richiedi 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

Il parametro ExternalURL specifica l'URL che si connette alla directory virtuale dall'esterno del firewall.

Il valore di questo parametro è importante quando le connessioni vengono crittografate da Transport Layer Security (TLS).

È necessario specificare un valore per questo parametro per consentire al servizio di individuazione automatica di restituire l'URL per la directory virtuale ECP.

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

Il parametro InternalURL specifica l'URL che si connette alla directory virtuale dall'interno del firewall.

Il valore di questo parametro è importante quando le connessioni vengono crittografate da Transport Layer Security (TLS).

È necessario specificare un valore per questo parametro per consentire al servizio di individuazione automatica di restituire l'URL per la directory virtuale ECP.

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

-Path

Il parametro Path consente di specificare il percorso del file system della directory virtuale del Pannello di controllo di Exchange. Si consiglia di utilizzare con attenzione questo parametro e solo nel caso in cui occorre utilizzare un percorso del file system diverso da quello predefinito.

Proprietà dei parametri

Tipo:	String
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

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

Proprietà dei parametri

Tipo:	VirtualDirectoryRole
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

-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

Non è possibile creare una directory virtuale del Pannello di controllo di Exchange in modalità remota. È possibile creare una directory virtuale del Pannello di controllo di Exchange solo sul computer locale.

Proprietà dei parametri

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

Set di parametri

(All)

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

-WebSiteName

Il parametro WebSiteName consente di specificare il nome del sito Web di IIS in cui viene creata la directory virtuale del Pannello di controllo di Exchange.

Proprietà dei parametri

Tipo:	String
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

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.

Commenti e suggerimenti

Questa pagina è stata utile?