New-ActiveSyncVirtualDirectory

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet New-ActiveSyncVirtualDirectory per creare Exchange ActiveSync directory virtuali utilizzate in Internet Information Services (IIS) nei server Microsoft Exchange.

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

Sintassi

Default (Impostazione predefinita) 

New-ActiveSyncVirtualDirectory
    [-ApplicationRoot <String>]
    [-AppPoolId <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalAuthenticationMethods <MultiValuedProperty>]
    [-ExternalUrl <Uri>]
    [-InstallProxySubDirectory <Boolean>]
    [-InternalAuthenticationMethods <MultiValuedProperty>]
    [-InternalUrl <Uri>]
    [-Path <String>]
    [-Role <VirtualDirectoryRole>]
    [-Server <ServerIdParameter>]
    [-WebSiteName <String>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il cmdlet New-ActiveSyncVirtualDirectory crea una directory virtuale Exchange ActiveSync nel server specificato nel sito Web specificato. La directory virtuale di Exchange ActiveSync creata è denominata Microsoft-Server-ActiveSync. In ogni sito Web di Exchange ActiveSync può esistere una sola directory virtuale di Exchange ActiveSync.

È 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

New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/Microsoft-Server-ActiveSync

In questo esempio viene creata una directory virtuale di Exchange ActiveSync e viene specificato l'URL esterno utilizzato per connettersi alla directory virtuale.

Esempio 2

New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/mail -InternalUrl https://contoso/mail

In questo esempio viene creata una directory virtuale di Exchange ActiveSync e vengono specificati gli URL esterni e interni utilizzati per connettersi alla directory virtuale.

Esempio 3

New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl "https://www.fourthcoffee.com/Microsoft-Server-ActiveSync"

In questo esempio viene creata una directory virtuale di Exchange ActiveSync per la società Fourth Coffee.

Parametri

-ApplicationRoot

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

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

-AppPoolId

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

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

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

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

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

-ExternalAuthenticationMethods

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro ExternalAuthenticationMethods limita i metodi di autenticazione che possono essere utilizzati per connettersi alla directory virtuale dall'esterno del firewall. I valori validi sono:

  • ADFS
  • Basic
  • Certificato
  • Del digest
  • Logistica di Amazon
  • Kerberos
  • LiveIdBasic
  • LiveIdFba
  • LiveIdNegotiate
  • NegoEx
  • Negoziare
  • Ntlm
  • OAuth
  • WindowsIntegrato
  • WSSecurity

WSSecurity

Anche se è possibile specificare uno di questi valori, il metodo di autenticazione effettivamente funzionante per le connessioni esterne dipende da altri fattori. Ad esempio:

  • Sebbene sia possibile specificare uno qualsiasi di questi valori, la validità del metodo di autenticazione per le connessioni interne dipende da altri fattori. Ad esempio:
  • Il metodo di autenticazione è disponibile sulla directory virtuale?

Il valore predefinito è vuoto ($null), che indica che tutti i metodi di autenticazione disponibili sono accettati.

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

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.

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

-InstallProxySubDirectory

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro InstallProxySubDirectory è stato utilizzato per creare una sottodirectory necessaria per l'inoltro delle connessioni ActiveSync con Exchange 2007.

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

-InternalAuthenticationMethods

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro InternalAuthenticationMethods limita i metodi di autenticazione che possono essere utilizzati per connettersi alla directory virtuale dall'interno del firewall. I valori validi sono:

  • ADFS
  • Basic
  • Certificato
  • Del digest
  • Logistica di Amazon
  • Kerberos
  • LiveIdBasic
  • LiveIdFba
  • LiveIdNegotiate
  • NegoEx
  • Negoziare
  • Ntlm
  • OAuth
  • WindowsIntegrato
  • WSSecurity

WSSecurity

Anche se è possibile specificare uno qualsiasi di questi valori, il metodo di autenticazione effettivamente funzionante per le connessioni interne dipende da altri fattori. Ad esempio:

  • Sebbene sia possibile specificare uno qualsiasi di questi valori, la validità del metodo di autenticazione per le connessioni interne dipende da altri fattori. Ad esempio:
  • Il metodo di autenticazione è disponibile sulla directory virtuale?

Il valore predefinito è vuoto ($null), che indica che tutti i metodi di autenticazione disponibili sono accettati.

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

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

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

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro Path consente di specificare il percorso del file system della directory virtuale. È consigliabile utilizzare questo parametro solo quando è necessario ricorrere a un percorso personalizzato per i file della directory virtuale. Il valore predefinito è vuoto ($null) a indicare che viene utilizzato il percorso 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

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

È 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) sul server Cassette postali.
  • Cassetta postale: configurare la directory virtuale per i servizi back-end nel server Cassette postali.

Le connessioni client vengono inoltrate 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

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro Server consente di specificare il server di 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

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

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro WebSiteName consente di specificare il nome del sito Web di IIS in cui viene creata la directory virtuale. Non è necessario utilizzare questo parametro per creare la directory virtuale nel sito Web 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

-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

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.