San

 

Applies To: Windows 7, Windows Server 2008 R2, Windows Server 2012 R2, Windows Server 2012, Windows 8

Displays or sets the storage area network (SAN) policy for the operating system.

Note

This command is only applicable to Windows 7 and Windows Server 2008 R2.

For an example of how this command can be used, see Examples.

Syntax

san [policy={OnlineAll | OfflineAll | OfflineShared}] [noerr]

Parameters

Parameter

Description

policy={ OnlineAll | OfflineAll | OfflineShared }]

Sets the SAN policy for the currently booted operating system. The SAN policy determines whether a newly discovered disk is brought online or remains offline, and whether it becomes read/write or remains read-only. When a disk is offline, the disk layout can be read, but no volume devices are surfaced through Plug and Play. This means that no file system can be mounted on the disk. When a disk is online, one or more volume devices are installed for the disk. The following is an explanation of each parameter:

  • OnlineAll. Specifies that all newly discovered disks will be brought online and made read/write.

    Important

    Specifying OnlineAll on a server that shares disks could lead to data corruption. Therefore, you should not set this policy if disks are shared among servers unless the server is part of a cluster.

  • OfflineAll. Specifies that all newly discovered disks except the startup disk will be offline and read-only by default.

  • OfflineShared. Specifies that all newly discovered disks that do not reside on a shared bus (such as SCSI and iSCSI) are brought online and made read-write. Disks that are left offline will be read-only by default.

For more information, see VDS_SAN_POLICY Enumeration (https://go.microsoft.com/fwlink/?LinkId=203815).

noerr

Used for scripting only. When an error is encountered, DiskPart continues to process commands as if the error did not occur. Without this parameter, an error causes DiskPart to exit with an error code.

Remarks

  • If the command is given with no parameters, the current SAN policy is displayed.

Examples

To view the current policy, type:

san

To make all newly discovered disks, except the startup disk, offline and read-only by default, type:

san policy=OfflineAll

Additional references