Initialize-Disk

Windows Server 2012 R2 and Windows 8.1

Initialize-Disk

Initializes a RAW disk for first time use, enabling the disk to be formatted and used to store data.

Sintaxis

Parameter Set: ByNumber
Initialize-Disk [-Number] <UInt32[]> [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByName
Initialize-Disk [-AsJob] [-CimSession <CimSession[]> ] [-FriendlyName <String[]> ] [-PartitionStyle <PartitionStyle> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByPath
Initialize-Disk -Path <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByUniqueId
Initialize-Disk -UniqueId <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByVirtualDisk
Initialize-Disk [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-PassThru] [-ThrottleLimit <Int32> ] [-VirtualDisk <CimInstance> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Initialize-Disk -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Descripción detallada

The Initialize-Disk cmdlet initializes a Disk object with the RAW partition style to either the MBR or GPT partition styles. The default partition style is GPT. Disks must be initialized before they can be formatted and used to store data.

Parámetros

-AsJob

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-CimSession<CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.


Alias

Session

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-FriendlyName<String[]>

Specifies the friendly name of the disk to initialize.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-InputObject<CimInstance[]>

Initializes the specified Disk object.


Alias

ninguno

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByValue)

¿Aceptar caracteres comodín?

false

-Number<UInt32[]>

Specifies the disk number of the disk to initialize.


Alias

ninguno

¿Requerido?

true

¿Posición?

1

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-PartitionStyle<PartitionStyle>

Specifies the type of the partition. The acceptable values for this parameter are: MBR or GPT. The disk must be set to read-write (IsReadOnly $false ) before this cmdlet will work.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

GPT

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-PassThru

Sends items from the interactive window down the pipeline as input to other cmdlets. By default, this cmdlet does not generate any output.
To send items from the interactive window down the pipeline, click to select the items and then click OK. Shift-click and Ctrl-click are supported.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Path<String[]>

Specifies the path of the disk to initialize.


Alias

ninguno

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-ThrottleLimit<Int32>

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet. Si se omite este parámetro o es especifica un valor de 0, Windows PowerShell ® calcula un límite óptimo para el cmdlet en función del número de cmdlets de CIM que se estén ejecutando en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-UniqueId<String[]>

Specifies the UniqueID of the disk to initialize


Alias

Id

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-VirtualDisk<CimInstance>

Specifies the VirtualDisk object for which you want to initialize the associated Disk object. The Virtual Disk CIM object is exposed by the Get-VirtualDisk cmdlet.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByValue)

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.


¿Requerido?

false

¿Posición?

named

Valor predeterminado

falso

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.


¿Requerido?

false

¿Posición?

named

Valor predeterminado

falso

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

Notas

  • El objeto Microsoft.Management.Infrastructure.CimInstance es una clase contenedora que muestra objetos de Instrumental de administración de Windows (WMI). La ruta de acceso después del signo de número (#) proporciona el espacio de nombres y el nombre de clase del objeto WMI subyacente.

Ejemplos

Example 1: Initialize a disk using default values

This example initializes the first disk in the computer (disk number 1), using the default values, which initializes the disk using the GPT partition style.


PS C:\> Initialize-Disk -Number 1

Example 2: Initialize a disk using the MBR partition style

This example initializes a disk using the MBR partition style.


PS C:\> Initialize-Disk -Number 1 -PartitionStyle MBR

Example 3: Initialize a virtual disk

This example uses the VirtualDisk parameter with the Get-VirtualDisk cmdlet to get a virtual disk with the friendly name UserData, and initialize the Disk object associated with the virtual disk.


PS C:\> Initialize-Disk -VirtualDisk (Get-VirtualDisk -FriendlyName UserData)

Temas relacionados

Adiciones de comunidad

AGREGAR
Mostrar: