Remove-AzRmStorageShare

Referencia

Módulo:: Az.Storage

Quita un recurso compartido de archivos de almacenamiento.

Sintaxis

Remove-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      -SnapshotTime <DateTime>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      -SnapshotTime <DateTime>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      [-ResourceId] <String>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      -InputObject <PSShare>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet New-AzRmStorageShare quita un recurso compartido de archivos de Storage.

Ejemplos

Ejemplo 1: Eliminación de un recurso compartido de archivos de almacenamiento con el nombre de la cuenta de almacenamiento y el nombre del recurso compartido

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare"

Este comando quita un recurso compartido de archivos de almacenamiento con el nombre de la cuenta de almacenamiento y el nombre del recurso compartido.

Ejemplo 2: Eliminación de un recurso compartido de archivos de almacenamiento con el objeto de cuenta de almacenamiento y el nombre del recurso compartido

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
Remove-AzRmStorageShare -StorageAccount $accountObject -Name "myshare"

Este comando quita un recurso compartido de archivos de Almacenamiento con el objeto de cuenta de Storage y el nombre del recurso compartido.

Ejemplo 3: Eliminación de todos los recursos compartidos de archivos de almacenamiento de una cuenta de almacenamiento con canalización

Get-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" | Remove-AzRmStorageShare -Force

Este comando quita todos los recursos compartidos de archivos de Storage de una cuenta de Almacenamiento con canalización.

Ejemplo 4: Eliminación de una única instantánea de recurso compartido de archivos de almacenamiento

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -SnapshotTime "2021-05-10T08:04:08Z"

Este comando quita una única instantánea de recurso compartido de archivos de almacenamiento con el nombre de recurso compartido específico y la hora de instantánea.

Ejemplo 5: Quitar un recurso compartido de archivos de almacenamiento y sus instantáneas

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Snapshots

Este comando quita un recurso compartido de archivos de almacenamiento y es instantáneas de forma predeterminada, el cmdlet producirá un error si el recurso compartido de archivos tiene instantáneas sin el parámetro "-include".

Ejemplo 6: Quitar un recurso compartido de archivos de almacenamiento y todas las instantáneas (incluir instantáneas alquiladas)

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Leased-Snapshots

Este comando quita un recurso compartido de archivos de Storage y todas las instantáneas, incluyen instantáneas alquiladas y no con concesión. De forma predeterminada, se producirá un error en el cmdlet si el recurso compartido de archivos tiene instantáneas sin el parámetro "-include".

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Force

Forzar a quitar share(snapshot) y todo el contenido de ella

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Include

Los valores válidos son: instantáneas, instantáneas alquiladas, ninguna. El valor predeterminado no es ninguno. Para "none", el recurso compartido de archivos se elimina si no tiene instantáneas de recurso compartido. Si el recurso compartido de archivos contiene instantáneas (alquiladas o no emitidas), se produce un error en la eliminación. Para "instantáneas", el recurso compartido de archivos se elimina, incluidas todas sus instantáneas de recurso compartido de archivos. Si el recurso compartido de archivos contiene instantáneas alquiladas, se produce un error en la eliminación. Para "leased-snapshots", el recurso compartido de archivos se elimina incluido todas sus instantáneas de recurso compartido de archivos (concesionadas o no emitidas).

Tipo:	String
Valores aceptados:	None, Snapshots, Leased-Snapshots
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Storage Share (objeto)

Tipo:	PSShare
Alias:	Share
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Nombre del recurso compartido

Tipo:	String
Alias:	N, ShareName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Indica que este cmdlet devuelve un valor booleano que refleja el éxito de la operación. De forma predeterminada, este cmdlet no devuelve un valor.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceId

Escriba un identificador de recurso del recurso compartido de archivos.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-SnapshotTime

Uso compartido de SnapshotTime

Tipo:	Nullable<T>[DateTime]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageAccount

Objeto de cuenta de almacenamiento

Tipo:	PSStorageAccount
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-StorageAccountName

Nombre de la cuenta de almacenamiento.

Tipo:	String
Alias:	AccountName
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

PSStorageAccount

PSShare

Salidas

Boolean

Compartir a través de