Aggiunta dell'aggiunta di archivi di <blocchi WebDAV>

Articolo
07/19/2023

Panoramica

Il modulo WebDAV è progettato per supportare più provider di archivi di blocco, definiti nella webdav/globalSettings/lockStores raccolta. Una serie di <add> elementi definisce le impostazioni per ogni provider di blocchi nella <lockStores> raccolta.

Nota

Attualmente l'unico provider dell'archivio proprietà è webdav_simple_lock, che archivia i blocchi WebDAV in memoria. Poiché questo provider archivia i blocchi in memoria, i blocchi vengono rilasciati automaticamente al riavvio di IIS o di un pool di applicazioni.

Compatibilità

Versione	Note
IIS 10.0	L'elemento `<add>` non è stato modificato in IIS 10.0.
IIS 8,5	L'elemento `<add>` non è stato modificato in IIS 8.5.
IIS 8,0	L'elemento `<add>` non è stato modificato in IIS 8.0.
IIS 7,5	L'elemento `<add>` dell'elemento `<lockStores>` viene fornito come funzionalità di IIS 7.5.
IIS 7.0	L'elemento `<add>` dell'elemento `<lockStores>` è stato introdotto in WebDAV 7.5 come parte di un download separato per IIS 7.0.
IIS 6.0	N/D

Nota

L'elemento <add> dell'elemento <lockStores> è stato definito nello schema WebDAV 7.0, ma è stato ignorato perché i blocchi WebDAV non sono stati implementati in tale versione.

Nota

I moduli WebDAV 7.0 e WebDAV 7.5 forniti fuori banda per IIS 7.0, che richiedevano il download e l'installazione dei moduli dall'URL seguente:

https://www.iis.net/expand/WebDAV

Con Windows 7 e Windows Server 2008 R2, il modulo WebDAV 7.5 viene fornito come funzionalità per IIS 7.5, quindi il download di WebDAV non è più necessario.

Installazione

Per supportare la pubblicazione WebDAV per il server Web, è necessario installare il modulo WebDAV. 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), server Web, espandere Server Web, espandere Funzionalità HTTP comuni e quindi selezionare Pubblicazione WebDAV. Fare clic su Avanti.
Nella pagina Selezione funzionalità fare 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, servizi Web a livello globale, funzionalità HTTP comuni, quindi selezionare Pubblicazione WebDAV.
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 Funzionalità HTTP comuni, selezionare Pubblicazione WebDAV e quindi 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, quindi Servizi Web a livello globale e quindi Funzionalità HTTP comuni.
Selezionare WebDAV Publishing (Pubblicazione WebDAV) e quindi fare clic su OK.

Windows Server 2008 o Windows Vista

Scaricare il pacchetto di installazione dall'URL seguente:
- https://www.iis.net/expand/WebDAV
Seguire le istruzioni della procedura dettagliata seguente per installare il modulo WebDAV:
- Installazione e configurazione di WebDAV in IIS 7.0

Procedure

Come configurare il blocco WebDAV per un sito Web

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 , quindi fare clic sul nome del sito.
Nel riquadro Home del sito fare doppio clic su WebDAV Authoring Rules (Regole di creazione WebDAV).
Quando viene visualizzata la pagina WebDAV Authoring Rules (Regole di creazione WebDAV ), fare clic su WebDAV Settings (Impostazioni WebDAV ) nel riquadro Azioni .
Quando viene visualizzata la pagina Impostazioni WebDAV , specificare le opzioni seguenti nella sezione Comportamento di blocco :
- Impostare Consenti blocchi su True.
- Per Archiviazione blocchi scegliere webdav_simple_lock dall'elenco a discesa.
- Impostare Richiedi blocco per la scrittura nell'impostazione desiderata.
Dopo aver completato i passaggi, fare clic su Applica nel riquadro Azioni .

Configurazione

L'elemento <lockStores> è configurabile solo a livello globale nel file ApplicationHost.config. Tutte le impostazioni a livello di sito o applicazione o in Web.config file vengono ignorate.

Attributi

Attributo	Descrizione
`name`	Attributo obbligatorio. Specifica il nome per un provider di archivi di blocchi.
`image`	Attributo obbligatorio. Specifica il percorso del file system per un provider di archivi di blocchi. Nota: In un sistema a 64 bit questo sarà il percorso a 64 bit, mentre in un sistema a 32 bit questo conterrà il percorso del provider a 32 bit e l'attributo `image32` verrà ignorato.
`image32`	Attributo facoltativo. Specifica il percorso a 32 bit per un provider di blocchi in un sistema a 64 bit. Nota: Questo attributo è stato aggiunto in WebDAV 7.5 e IIS 7.5.

Elementi figlio

Nessuno.

Esempio di configurazione

Nell'esempio seguente viene elencato un <globalSettings> elemento di esempio per un server WebDAV. Questo esempio definisce i provider semplici predefiniti per i blocchi e le proprietà e abilita i blocchi WebDAV per il server.

<system.webServer>
      <webdav>
         <globalSettings>
            <propertyStores>
               <add name="webdav_simple_prop" image="%windir%\system32\inetsrv\webdav_simple_prop.dll" />
            </propertyStores>
            <lockStores>
               <add name="webdav_simple_lock" image="%windir%\system32\inetsrv\webdav_simple_lock.dll" />
            </lockStores>
         </globalSettings>
         <authoring>
            <locks enabled="true" lockStore="webdav_simple_lock" />
         </authoring>
      </webdav>
   </system.webServer>

Codice di esempio

Nota

Le propertyStores raccolte e lockStores vengono popolate con le proprietà predefinite e i provider di blocchi quando si installa WebDAV. Queste raccolte di provider non sono estendibili in questo momento, quindi gli esempi di codice in questa sezione sono solo per riferimento.

Negli esempi seguenti vengono configurate le impostazioni globali WebDAV per aggiungere nuovamente le proprietà predefinite e i provider di blocco copiati nel sistema quando si installa il modulo WebDAV.

AppCmd.exe

appcmd.exe set config -section:system.webServer/webdav/globalSettings /+"propertyStores.[name='webdav_simple_prop',image='%windir%\system32\inetsrv\webdav_simple_prop.dll']" /commit:apphost

appcmd.exe set config -section:system.webServer/webdav/globalSettings /+"lockStores.[name='webdav_simple_lock',image='%windir%\system32\inetsrv\webdav_simple_lock.dll']" /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 globalSettingsSection = config.GetSection("system.webServer/webdav/globalSettings");

         ConfigurationElementCollection propertyStoresCollection = globalSettingsSection.GetCollection("propertyStores");

         ConfigurationElement addElement = propertyStoresCollection.CreateElement("add");
         addElement["name"] = @"webdav_simple_prop";
         addElement["image"] = @"%windir%\system32\inetsrv\webdav_simple_prop.dll";
         propertyStoresCollection.Add(addElement);

         ConfigurationElementCollection lockStoresCollection = globalSettingsSection.GetCollection("lockStores");

         ConfigurationElement addElement1 = lockStoresCollection.CreateElement("add");
         addElement1["name"] = @"webdav_simple_lock";
         addElement1["image"] = @"%windir%\system32\inetsrv\webdav_simple_lock.dll";
         lockStoresCollection.Add(addElement1);

         serverManager.CommitChanges();
      }
   }
}

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 globalSettingsSection As ConfigurationSection = config.GetSection("system.webServer/webdav/globalSettings")

      Dim propertyStoresCollection As ConfigurationElementCollection = globalSettingsSection.GetCollection("propertyStores")

      Dim addElement As ConfigurationElement = propertyStoresCollection.CreateElement("add")
      addElement("name") = "webdav_simple_prop"
      addElement("image") = "%windir%\system32\inetsrv\webdav_simple_prop.dll"
      propertyStoresCollection.Add(addElement)

      Dim lockStoresCollection As ConfigurationElementCollection = globalSettingsSection.GetCollection("lockStores")

      Dim addElement1 As ConfigurationElement = lockStoresCollection.CreateElement("add")
      addElement1("name") = "webdav_simple_lock"
      addElement1("image") = "%windir%\system32\inetsrv\webdav_simple_lock.dll"
      lockStoresCollection.Add(addElement1)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var globalSettingsSection = adminManager.GetAdminSection("system.webServer/webdav/globalSettings", "MACHINE/WEBROOT/APPHOST");

var propertyStoresCollection = globalSettingsSection.ChildElements.Item("propertyStores").Collection;

var addElement = propertyStoresCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "webdav_simple_prop";
addElement.Properties.Item("image").Value = "%windir%\\system32\\inetsrv\\webdav_simple_prop.dll";
propertyStoresCollection.AddElement(addElement);

var lockStoresCollection = globalSettingsSection.ChildElements.Item("lockStores").Collection;

var addElement1 = lockStoresCollection.CreateNewElement("add");
addElement1.Properties.Item("name").Value = "webdav_simple_lock";
addElement1.Properties.Item("image").Value = "%windir%\\system32\\inetsrv\\webdav_simple_lock.dll";
lockStoresCollection.AddElement(addElement1);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set globalSettingsSection = adminManager.GetAdminSection("system.webServer/webdav/globalSettings", "MACHINE/WEBROOT/APPHOST")

Set propertyStoresCollection = globalSettingsSection.ChildElements.Item("propertyStores").Collection

Set addElement = propertyStoresCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "webdav_simple_prop"
addElement.Properties.Item("image").Value = "%windir%\system32\inetsrv\webdav_simple_prop.dll"
propertyStoresCollection.AddElement(addElement)

Set lockStoresCollection = globalSettingsSection.ChildElements.Item("lockStores").Collection

Set addElement1 = lockStoresCollection.CreateNewElement("add")
addElement1.Properties.Item("name").Value = "webdav_simple_lock"
addElement1.Properties.Item("image").Value = "%windir%\system32\inetsrv\webdav_simple_lock.dll"
lockStoresCollection.AddElement(addElement1)

adminManager.CommitChanges()

Condividi tramite

Aggiunta dell'aggiunta di archivi di <blocchi WebDAV>

Panoramica

Compatibilità

Installazione

Windows Server 2012 o Windows Server 2012 R2

Windows 8 o Windows 8.1

Windows Server 2008 R2

Windows 7

Windows Server 2008 o Windows Vista

Procedure

Come configurare il blocco WebDAV per un sito Web

Configurazione

Attributi

Elementi figlio

Esempio di configurazione

Codice di esempio

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Commenti e suggerimenti

Risorse aggiuntive