FTP Impostazioni <a livello di sito ftpServer>
Panoramica
L'elemento <ftpServer> dell'elemento <site> specifica le impostazioni a livello di sito per le funzionalità FTP per i siti FTP.
In IIS 6.0 le impostazioni per il servizio FTP sono state archiviate in una sezione separata della metabase rispetto ai siti Web. In IIS 7 e versioni successive, le impostazioni FTP vengono archiviate nel file ApplicationHost.config all'interno degli stessi <site> elementi e <siteDefaults> che archiviano le impostazioni per i siti Web. Per questo motivo, le impostazioni specificate nell'elemento <ftpServer> non possono essere delegate, né possono essere specificate all'interno <location> di elementi.
Nota
Le impostazioni FTP aggiuntive vengono archiviate nella <system.ftpServer> sezione del file ApplicationHost.config e queste impostazioni vengono specificate all'interno <location> di elementi.
Compatibilità
| Versione | Note |
|---|---|
| IIS 10.0 | L'elemento <ftpServer> non è stato modificato in IIS 10.0. |
| IIS 8,5 | L'elemento <ftpServer> non è stato modificato in IIS 8.5. |
| IIS 8,0 | L'elemento <ftpServer> non è stato modificato in IIS 8.0. |
| IIS 7,5 | L'elemento <ftpServer> viene fornito come funzionalità di IIS 7.5. |
| IIS 7.0 | L'elemento <ftpServer> è stato introdotto in FTP 7.0, che era un download separato per IIS 7.0. |
| IIS 6.0 | L'elemento <ftpServer> e i relativi elementi figlio sostituiscono le impostazioni FTP di IIS 6.0 che si trovano nel percorso della metabase LM/MSFTPSVC . |
Nota
I servizi FTP 7.0 e FTP 7.5 forniti fuori banda per IIS 7.0, che richiedevano il download e l'installazione dei moduli dall'URL seguente:
Con Windows 7 e Windows Server 2008 R2, il servizio FTP 7.5 viene fornito come funzionalità per IIS 7.5, quindi il download del servizio FTP non è più necessario.
Installazione
Per supportare la pubblicazione FTP per il server Web, è necessario installare il servizio FTP. A tale scopo, seguire questa procedura.
Windows Server 2012 o Windows Server 2012 R2
Sulla barra delle applicazioni fare clic su Server Manager.
In Server Manager fare clic sul menu Gestisci e quindi su Aggiungi ruoli e funzionalità.
Nella procedura guidata Aggiungi ruoli e funzionalità fare clic su Avanti. Selezionare il tipo di installazione e fare clic su Avanti. Selezionare il server di destinazione e fare clic su Avanti.
Nella pagina Ruoli server espandere Server Web (IIS) e quindi selezionare Server FTP.
Nota
Per supportare ASP. Autenticazione di appartenenza o autenticazione di Gestione IIS per il servizio FTP, sarà necessario selezionare Estendibilità FTP, oltre al servizio FTP.
.Fare clic su Avanti e quindi nella pagina Seleziona funzionalità fare di nuovo clic su Avanti .
Nella pagina Conferma selezioni per l'installazione fare clic su Installa.
Nella pagina Risultati fare clic su Chiudi.
Windows 8 o Windows 8.1
Nella schermata Start spostare il puntatore fino all'angolo inferiore sinistro, fare clic con il pulsante destro del mouse sul pulsante Start e quindi scegliere Pannello di controllo.
In Pannello di controllo fare clic su Programmi e funzionalità e quindi su Attiva o disattiva funzionalità di Windows.
Espandere Internet Information Services e quindi selezionare Server FTP.
Nota
Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di Gestione IIS per il servizio FTP, sarà anche necessario selezionare Estendibilità FTP.
Fare clic su OK.
Fare clic su Close.
Windows Server 2008 R2
Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Server Manager.
Nel riquadro della gerarchia Server Manager espandere Ruoli, quindi fare clic su Server Web (IIS).
Nel riquadro Server Web (IIS) scorrere fino alla sezione Servizi ruolo e quindi fare clic su Aggiungi servizi ruolo.
Nella pagina Selezione servizi ruolo della Procedura guidata Aggiungi servizi ruolo espandere Server FTP.
Selezionare Servizio FTP.
Nota
Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di Gestione IIS per il servizio FTP, sarà anche necessario selezionare Estendibilità FTP.
Fare clic su Avanti.
Nella pagina Conferma selezioni per l'installazione fare clic su Installa.
Nella pagina Risultati fare clic su Chiudi.
Windows 7
Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
In Pannello di controllo fare clic su Programmi e funzionalità e quindi su Attiva o disattiva funzionalità di Windows.
Espandere Internet Information Services e quindi server FTP.
Selezionare Servizio FTP.
Nota
Per supportare ASP. L'autenticazione di appartenenza o l'autenticazione di Gestione IIS per il servizio FTP, sarà anche necessario selezionare Estendibilità FTP.
Fare clic su OK.
Windows Server 2008 o Windows Vista
Scaricare il pacchetto di installazione dall'URL seguente:
Seguire le istruzioni riportate nella procedura dettagliata seguente per installare il servizio FTP:
Procedure
Come abilitare o disabilitare l'autenticazione anonima per un sito FTP
Aprire Gestione Internet Information Services (IIS):
Se si usa Windows Server 2012 o Windows Server 2012 R2:
- Sulla barra delle applicazioni fare clic su Server Manager, scegliere Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows 8 o Windows 8.1:
- Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
- Fare clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).
Se si usa Windows Server 2008 o Windows Server 2008 R2:
- Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows Vista o Windows 7:
- Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
- Fare doppio clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).
Nel riquadro Connessioni espandere il nome del server, espandere il nodo Siti e quindi fare clic sul nome del sito.
Nel riquadro Home del sito fare doppio clic sulla funzionalità Autenticazione FTP .
Nella pagina Autenticazione FTP selezionare Autenticazione anonima.
Nel riquadro Azioni fare clic su Abilita per abilitare l'autenticazione anonima oppure fare clic su Disabilita per disabilitare l'autenticazione anonima.
Come usare la Creazione guidata sito FTP per creare un sito FTP con accesso in lettura anonimo
Aprire Gestione Internet Information Services (IIS):
Se si usa Windows Server 2012 o Windows Server 2012 R2:
- Nella barra delle applicazioni fare clic su Server Manager, scegliere Strumenti e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows 8 o Windows 8.1:
- Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
- Fare clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Se si usa Windows Server 2008 o Windows Server 2008 R2:
- Nella barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows Vista o Windows 7:
- Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.
- Fare doppio clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Nel riquadro Connessioni fare clic sul nodo Siti nell'albero.
Fare clic con il pulsante destro del mouse sul nodo Siti nell'albero e scegliere Aggiungi sito FTP oppure fare clic su Aggiungi sito FTP nel riquadro Azioni .
Quando viene visualizzata la procedura guidata Aggiungi sito FTP :
Immettere "Nuovo sito FTP" nella casella nome sito FTP .
Per la casella Percorso fisico , è possibile usare una delle opzioni seguenti per specificare la directory del contenuto:
- Fare clic sul pulsante con i puntini di sospensione (...) e quindi passare alla cartella contenente il contenuto per il sito FTP.
- Digitare il percorso della cartella del contenuto nella casella. Si noti che se si sceglie di digitare il percorso, è possibile usare le variabili di ambiente nei percorsi. Ad esempio, è possibile usare "%SystemDrive%\inetpub\ftproot" per la directory del contenuto.
Al termine di questi elementi, fare clic su Avanti.
Nella seconda pagina della procedura guidata Aggiungi sito FTP :
Scegliere un indirizzo IP per il sito FTP dall'elenco a discesa Indirizzo IP oppure scegliere di accettare la selezione predefinita di "Tutti non assegnati".
Immettere la porta TCP/IP per il sito FTP nella casella Porta . Per impostazione predefinita, i siti FTP e i client usano la porta 21. Nota: per specificare FTPS implicito, è necessario usare la porta 990.
Per usare un nome host virtuale FTP, selezionare la casella Abilita nomi host virtuali, quindi immettere il nome host virtuale nella casella Host virtuale .
Per le opzioni SSL, scegliere una delle opzioni seguenti:
- Selezionare No SSL per disabilitare le opzioni SSL.
- Selezionare Consenti SSL per consentire ai client FTP di usare facoltativamente FTP tramite SSL quando si connettono con il server FTP.
- Selezionare Richiedi SSL per consentire ai client FTP di usare sempre FTP tramite SSL quando si connettono al server FTP.
- Se si sceglie Consenti SSL o Richiedi SSL, scegliere un certificato dal menu a discesa Certificato SSL .
Al termine di questi elementi, fare clic su Avanti.
Nella pagina successiva della procedura guidata:
- Selezionare Anonimo per le impostazioni di autenticazione .
- Per le impostazioni di autorizzazione, scegliere "Utenti anonimi" dall'elenco a discesa Consenti l'accesso.
- Selezionare Lettura per l'opzione Autorizzazioni .
- Al termine di questi elementi, fare clic su Fine.
Come abilitare o disabilitare l'autenticazione di base per un sito FTP
Aprire Gestione Internet Information Services (IIS):
Se si usa Windows Server 2012 o Windows Server 2012 R2:
- Nella barra delle applicazioni fare clic su Server Manager, scegliere Strumenti e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows 8 o Windows 8.1:
- Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
- Fare clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Se si usa Windows Server 2008 o Windows Server 2008 R2:
- Nella barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows Vista o Windows 7:
- Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.
- Fare doppio clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Nel riquadro Connessioni espandere il nome del server, espandere il nodo Siti e quindi fare clic sul nome del sito.
Nel riquadro Home del sito fare doppio clic sulla funzionalità Di autenticazione FTP .
Nella pagina Autenticazione FTP selezionare Autenticazione di base.
Nel riquadro Azioni fare clic su Abilita per abilitare l'autenticazione di base o fare clic su Disabilita per disabilitare l'autenticazione di base.
Come usare la Creazione guidata sito FTP per creare un sito FTP con l'autenticazione di base e l'accesso in lettura/scrittura
Aprire Gestione Internet Information Services (IIS):
Se si usa Windows Server 2012 o Windows Server 2012 R2:
- Nella barra delle applicazioni fare clic su Server Manager, scegliere Strumenti e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows 8 o Windows 8.1:
- Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
- Fare clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Se si usa Windows Server 2008 o Windows Server 2008 R2:
- Nella barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione e quindi fare clic su Gestione Internet Information Services (IIS).
Se si usa Windows Vista o Windows 7:
- Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.
- Fare doppio clic su Strumenti di amministrazione e quindi fare doppio clic su Gestione Internet Information Services (IIS).
Nel riquadro Connessioni fare clic sul nodo Siti nell'albero.
Fare clic con il pulsante destro del mouse sul nodo Siti nell'albero e scegliere Aggiungi sito FTP oppure fare clic su Aggiungi sito FTP nel riquadro Azioni .
Quando viene visualizzata la procedura guidata Aggiungi sito FTP :
Immettere "Nuovo sito FTP" nella casella nome sito FTP .
Per la casella Percorso fisico , è possibile usare una delle opzioni seguenti per specificare la directory del contenuto:
- Fare clic sul pulsante con i puntini di sospensione (...) e quindi passare alla cartella contenente il contenuto per il sito FTP.
- Digitare il percorso della cartella del contenuto nella casella. Si noti che se si sceglie di digitare il percorso, è possibile usare le variabili di ambiente nei percorsi. Ad esempio, è possibile usare "%SystemDrive%\inetpub\ftproot" per la directory del contenuto.
Al termine di questi elementi, fare clic su Avanti.
Nella seconda pagina della procedura guidata Aggiungi sito FTP :
Scegliere un indirizzo IP per il sito FTP dall'elenco a discesa Indirizzo IP oppure scegliere di accettare la selezione predefinita di "Tutti non assegnati".
Immettere la porta TCP/IP per il sito FTP nella casella Porta . Per impostazione predefinita, i siti FTP e i client usano la porta 21. Nota: per specificare FTPS implicito, è necessario usare la porta 990.
Per usare un nome host virtuale FTP, selezionare la casella Abilita nomi host virtuali, quindi immettere il nome host virtuale nella casella Host virtuale .
Per le opzioni SSL, scegliere una delle opzioni seguenti:
- Selezionare No SSL per disabilitare le opzioni SSL.
- Selezionare Consenti SSL per consentire ai client FTP di usare facoltativamente FTP tramite SSL quando si connettono con il server FTP.
- Selezionare Richiedi SSL per consentire ai client FTP di usare sempre FTP tramite SSL quando si connettono al server FTP.
- Se si sceglie Consenti SSL o Richiedi SSL, scegliere un certificato dal menu a discesa Certificato SSL .
Al termine di questi elementi, fare clic su Avanti.
Nella pagina successiva della procedura guidata:
- Selezionare Basic per le impostazioni di autenticazione .
- Per le impostazioni di autorizzazione , scegliere "Utenti specificati" dall'elenco a discesa Consenti l'accesso e immettere un nome account nella casella sotto il menu a discesa.
- Selezionare Lettura e scrittura per l'opzione Autorizzazioni .
- Al termine di questi elementi, fare clic su Fine.
Configurazione
L'elemento specifico <ftpServer> del <site> sito è configurato a livello.
Attributi
| Attributo | Descrizione | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
allowUTF8 |
Attributo Boolean facoltativo. true se UTF8 è abilitato; in caso contrario, false. Il valore predefinito è true. |
||||||||||||
serverAutoStart |
Attributo Boolean facoltativo. true se IIS deve avviare automaticamente il sito FTP all'avvio del servizio FTP; in caso contrario, false. Il valore predefinito è true. |
||||||||||||
state |
Attributo enumerazione di sola lettura generato dinamicamente. Specifica lo stato di runtime corrente per un sito FTP. I valori possibili sono:
None. |
||||||||||||
lastStartupStatus |
Attributo uint generato dinamicamente. Specifica lo stato dall'ultimo avvio del sito FTP. Non esiste alcun valore predefinito e l'attributo non è configurabile. |
Elementi figlio
| Elemento | Descrizione |
|---|---|
connections |
Elemento facoltativo. Specifica le impostazioni specifiche della connessione per un sito FTP. |
security |
Elemento facoltativo. Specifica le impostazioni correlate alla sicurezza per un sito FTP. |
customFeatures |
Elemento facoltativo. Specifica una raccolta di provider FTP personalizzati sviluppati tramite l'estendibilità FTP FTP. |
messages |
Elemento facoltativo. Specifica i messaggi correlati alla connessione visualizzati da un sito FTP ai client FTP. |
fileHandling |
Elemento facoltativo. Specifica le impostazioni di gestione dei file per un sito FTP. |
firewallSupport |
Elemento facoltativo. Specifica le impostazioni per un sito FTP necessario per le connessioni FTP effettuate tramite un firewall. |
userIsolation |
Elemento facoltativo. Specifica il comportamento di ricerca della home directory per le connessioni FTP. Ad esempio, gli utenti possono essere limitati a una home directory basata sul nome di accesso. |
directoryBrowse |
Elemento facoltativo. Specifica le opzioni di elenco delle directory per un sito FTP. Queste impostazioni influiscono sul modo in cui il servizio FTP visualizzerà elenchi di directory nei client FTP. |
logfile |
Elemento facoltativo. Specifica le opzioni di registrazione per un sito FTP. |
sessions |
Elemento di sola lettura generato dinamicamente. Contiene una raccolta di sessioni FTP attualmente connesse. Ogni sessione contiene vari metadati, ad esempio l'indirizzo IP del client, il comando attualmente eseguito e così via. |
Metodi
| Metodo | Descrizione |
|---|---|
Start |
Avvia un sito FTP. |
Stop |
Arresta un sito FTP. |
FlushLog |
Scarica il file di log per un sito FTP. |
Esempio di configurazione
L'esempio seguente illustra diverse impostazioni di configurazione nell'elemento <ftpServer> per un sito FTP. In particolare, le <site> impostazioni in questo esempio illustrano come:
- Creare un sito FTP e aggiungere l'associazione per il protocollo FTP sulla porta 21.
- Configurare le opzioni SSL FTP per consentire l'accesso sicuro sia nel controllo che nel canale dati usando un certificato.
- Disabilitare l'autenticazione anonima e abilitare l'autenticazione di base per FTP.
- Negare l'accesso per il comando SYST FTP.
- Specificare il formato di elenco di directory UNIX.
- Configurare le opzioni di registrazione.
- Specificare un messaggio di benvenuto personalizzato e abilitare i messaggi di errore dettagliati locali.
- Specificare che gli utenti inizieranno in una home directory basata sul nome di accesso, ma solo se esiste tale directory.
<site name="ftp.example.com" id="5">
<application path="/">
<virtualDirectory path="/" physicalPath="c:\inetpub\www.example.com" />
</application>
<bindings>
<binding protocol="ftp" bindingInformation="*:21:" />
</bindings>
<ftpServer>
<security>
<ssl controlChannelPolicy="SslAllow"
dataChannelPolicy="SslAllow"
serverCertHash="57686f6120447564652c2049495320526f636b73" />
<authentication>
<basicAuthentication enabled="true" />
<anonymousAuthentication enabled="false" />
</authentication>
<commandFiltering maxCommandLine="4096" allowUnlisted="true">
<add command="SYST" allowed="false" />
</commandFiltering>
</security>
<directoryBrowse showFlags="StyleUnix" />
<logFile logExtFileFlags="Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, FtpStatus, Win32Status, ServerPort, FtpSubStatus, Session, FullPath, Info" />
<messages expandVariables="true"
greetingMessage="Welcome %UserName%!"
allowLocalDetailedErrors="true" />
<userIsolation mode="StartInUsersDirectory" />
</ftpServer>
</site>
L'esempio seguente illustra diverse impostazioni di configurazione correlate alla sicurezza nell'elemento <system.ftpServer> per un sito FTP. In particolare, le <location> impostazioni in questo esempio illustrano come:
- Specificare una regola di autorizzazione FTP per l'accesso in lettura e scrittura per il gruppo administrators.
- Specificare le opzioni di filtro delle richieste FTP che negano *.exe, *.bat e file *.cmd.
- Specificare i limiti delle richieste FTP per una lunghezza massima del contenuto di 1000000 byte e una lunghezza massima di URL pari a 1024 byte.
- Bloccare l'accesso FTP alla directory virtuale _vti_bin, usata con le estensioni del server FrontPage.
- Specificare le opzioni di filtro IP FTP che consentono l'accesso da 127.0.0.1 e negare l'accesso dall'intervallo di indirizzi IP 169.254.0.0/255.0.0.0.
<location path="ftp.example.com">
<system.ftpServer>
<security>
<authorization>
<add accessType="Allow" roles="administrators" permissions="Read, Write" />
</authorization>
<requestFiltering>
<fileExtensions allowUnlisted="true">
<add fileExtension=".exe" allowed="false" />
<add fileExtension=".bat" allowed="false" />
<add fileExtension=".cmd" allowed="false" />
</fileExtensions>
<requestLimits maxAllowedContentLength="1000000" maxUrl="1024" />
<hiddenSegments>
<add segment="_vti_bin" />
</hiddenSegments>
</requestFiltering>
<ipSecurity enableReverseDns="false" allowUnlisted="true">
<add ipAddress="127.0.0.1" allowed="true" />
<add ipAddress="169.254.0.0" subnetMask="255.255.0.0" allowed="false" />
</ipSecurity>
</security>
</system.ftpServer>
</location>
Codice di esempio
Gli esempi seguenti configurano un sito FTP per usare lo stile UNIX per gli elenchi di directory e per visualizzare l'archiviazione della directory disponibile in byte.
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites /[name='ftp.example.com'].ftpServer.directoryBrowse.showFlags:"StyleUnix, DisplayAvailableBytes" /commit:apphost
Nota
È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. Questa operazione esegue il commit delle impostazioni di configurazione nella sezione percorso appropriata nel file di ApplicationHost.config.
C#
using System;
using System.Text;
using Microsoft.Web.Administration;
internal static class Sample
{
private static void Main()
{
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetApplicationHostConfiguration();
ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"ftp.example.com");
if (siteElement == null) throw new InvalidOperationException("Element not found!");
ConfigurationElement ftpServerElement = siteElement.GetChildElement("ftpServer");
ConfigurationElement directoryBrowseElement = ftpServerElement.GetChildElement("directoryBrowse");
directoryBrowseElement["showFlags"] = @"StyleUnix, DisplayAvailableBytes";
serverManager.CommitChanges();
}
}
private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
{
foreach (ConfigurationElement element in collection)
{
if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
{
bool matches = true;
for (int i = 0; i < keyValues.Length; i += 2)
{
object o = element.GetAttributeValue(keyValues[i]);
string value = null;
if (o != null)
{
value = o.ToString();
}
if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
{
matches = false;
break;
}
}
if (matches)
{
return element;
}
}
}
return null;
}
}
VB.NET
Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
Sub Main()
Dim serverManager As ServerManager = New ServerManager
Dim config As Configuration = serverManager.GetApplicationHostConfiguration
Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
Dim sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "ftp.example.com")
If (siteElement Is Nothing) Then
Throw New InvalidOperationException("Element not found!")
End If
Dim ftpServerElement As ConfigurationElement = siteElement.GetChildElement("ftpServer")
Dim directoryBrowseElement As ConfigurationElement = ftpServerElement.GetChildElement("directoryBrowse")
directoryBrowseElement("showFlags") = "StyleUnix, DisplayAvailableBytes"
serverManager.CommitChanges()
End Sub
Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
For Each element As ConfigurationElement In collection
If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
Dim matches As Boolean = True
Dim i As Integer
For i = 0 To keyValues.Length - 1 Step 2
Dim o As Object = element.GetAttributeValue(keyValues(i))
Dim value As String = Nothing
If (Not (o) Is Nothing) Then
value = o.ToString
End If
If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
matches = False
Exit For
End If
Next
If matches Then
Return element
End If
End If
Next
Return Nothing
End Function
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "ftp.example.com"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);
var ftpServerElement = siteElement.ChildElements.Item("ftpServer");
var directoryBrowseElement = ftpServerElement.ChildElements.Item("directoryBrowse");
directoryBrowseElement.Properties.Item("showFlags").Value = "StyleUnix, DisplayAvailableBytes";
adminManager.CommitChanges();
function FindElement(collection, elementTagName, valuesToMatch) {
for (var i = 0; i < collection.Count; i++) {
var element = collection.Item(i);
if (element.Name == elementTagName) {
var matches = true;
for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
var property = element.GetPropertyByName(valuesToMatch[iVal]);
var value = property.Value;
if (value != null) {
value = value.toString();
}
if (value != valuesToMatch[iVal + 1]) {
matches = false;
break;
}
}
if (matches) {
return i;
}
}
}
return -1;
}
VBScript
Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "ftp.example.com"))
If siteElementPos = -1 Then
WScript.Echo "Element not found!"
WScript.Quit
End If
Set siteElement = sitesCollection.Item(siteElementPos)
Set ftpServerElement = siteElement.ChildElements.Item("ftpServer")
Set directoryBrowseElement = ftpServerElement.ChildElements.Item("directoryBrowse")
directoryBrowseElement.Properties.Item("showFlags").Value = "StyleUnix, DisplayAvailableBytes"
adminManager.CommitChanges()
Function FindElement(collection, elementTagName, valuesToMatch)
For i = 0 To CInt(collection.Count) - 1
Set element = collection.Item(i)
If element.Name = elementTagName Then
matches = True
For iVal = 0 To UBound(valuesToMatch) Step 2
Set property = element.GetPropertyByName(valuesToMatch(iVal))
value = property.Value
If Not IsNull(value) Then
value = CStr(value)
End If
If Not value = CStr(valuesToMatch(iVal + 1)) Then
matches = False
Exit For
End If
Next
If matches Then
Exit For
End If
End If
Next
If matches Then
FindElement = i
Else
FindElement = -1
End If
End Function