Set-EcpVirtualDirectory

Modulo:: Exchange PowerShell

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet Set-EcpVirtualDirectory per modificare le directory virtuali di Exchange Pannello di controllo (ECP) utilizzate in Internet Information Services (IIS) sui server Microsoft Exchange. La directory virtuale ECP gestisce l'interfaccia di amministrazione di Exchange.

L'interfaccia di gestione Web ECP è stata introdotta in Exchange Server 2010. In Exchange Server 2013 ed Exchange Server 2016 le directory virtuali dell'interfaccia di amministrazione di Exchange e i cmdlet di gestione corrispondenti usano ancora ECP nel nome. È possibile utilizzare questi cmdlet per gestire le directory virtuali ECP sui 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)

Set-EcpVirtualDirectory
    [-Identity] <VirtualDirectoryIdParameter>
    [-AdfsAuthentication <Boolean>]
    [-AdminEnabled <Boolean>]
    [-BasicAuthentication <Boolean>]
    [-Confirm]
    [-DigestAuthentication <Boolean>]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalAuthenticationMethods <MultiValuedProperty>]
    [-ExternalUrl <Uri>]
    [-FormsAuthentication <Boolean>]
    [-GzipLevel <GzipLevel>]
    [-InternalUrl <Uri>]
    [-OAuthAuthentication <Boolean>]
    [-OwaOptionsEnabled <Boolean>]
    [-WhatIf]
    [-WindowsAuthentication <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-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -BasicAuthentication:$false

In questo esempio viene disabilitata l'autenticazione di base nella directory virtuale ECP predefinita sul server denominato Server01.

Esempio 2

Set-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -AdminEnabled $false

In questo esempio viene disattivato l'accesso Internet all'interfaccia di amministrazione di Exchange sul server denominato Server01.

Parametri

-AdfsAuthentication

Il parametro AdfsAuthentication specifica che la directory virtuale ECP consente agli utenti di eseguire l'autenticazione tramite l'autenticazione di Active Directory Federation Services (AD FS). Questo parametro accetta $true o $false. Il valore predefinito è $false.

Le impostazioni dell'autenticazione a ADFS per Set-OwaVirtualDirectory e Set-EcpVirtualDirectory sono correlate. È necessario impostare il parametro AdfsAuthentication in Set-EcpVirtualDirectory su $true prima di poter impostare il parametro AdfsAuthentication in Set-OwaVirtualDirectory su $true. In modo analogo, è necessario impostare il parametro AdfsAuthentication in Set-OwaVirtualDirectory su $false prima di poter impostare il parametro AdfsAuthentication in Set-EcpVirtualDirectory su $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

-AdminEnabled

Il parametro AdminEnabled specifica che non è possibile accedere all'EAC tramite Internet. Per ulteriori informazioni, vedere Disattivare l'accesso all'interfaccia di amministrazione di Exchange. Questo parametro accetta $true o $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

-BasicAuthentication

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.

Il parametro può essere utilizzato con il parametro FormsAuthentication o con i parametri DigestAuthentication e WindowsAuthentication.

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

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

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

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

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

-ExternalAuthenticationMethods

Il parametro ExternalAuthenticationMethods consente di specificare i metodi di autenticazione supportati sul server Exchange dall'esterno del firewall.

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

-ExternalUrl

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

È 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

-FormsAuthentication

Il parametro FormsAuthentication consente di specificare se l'autenticazione basata su form è abilitata nella directory virtuale ECP. I valori validi sono:

$true: l'autenticazione basata su form è abilitata. Il parametro BasicAuthentication è impostato su $true e i parametri DigestAuthentication e WindowsAuthentication sono impostati su $false.
$false: L'autenticazione basata su form è 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

-GzipLevel

Il parametro GzipLevel consente di impostare le informazioni di configurazione Gzip per la directory virtuale di ECP.

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

Il parametro Identity consente di specificare la directory virtuale ECP 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*.

Per gestire la prima directory virtuale ECP creata in un'organizzazione di Exchange, è necessario utilizzare questo cmdlet nel computer che include la prima directory virtuale ECP. Se si creano directory virtuali ECP aggiuntive, è possibile gestirle in modalità remota.

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

-InternalUrl

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

È 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

-OAuthAuthentication

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

-OwaOptionsEnabled

Il parametro OwaOptionsEnabled consente di specificare che Opzioni di Outlook sul Web è abilitato per gli utenti finali. Se questo parametro è impostato su $false, gli utenti non potranno accedere Outlook sul web opzioni. Può essere utile disabilitare l'accesso se l'organizzazione usa strumenti non del provider Microsoft. Questo parametro accetta $true o $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

-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

-WindowsAuthentication

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

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?