Remove-AzRmStorageShare

Referencia

Módulo:: Az.Storage

Quita un recurso compartido de archivos de almacenamiento.

Syntax

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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Accepted values:	None, Snapshots, Leased-Snapshots
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Storage Share (objeto)

Type:	PSShare
Aliases:	Share
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nombre del recurso compartido

Type:	String
Aliases:	N, ShareName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nombre del grupo de recursos.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Escriba un identificador de recurso del recurso compartido de archivos.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SnapshotTime

Uso compartido de SnapshotTime

Type:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccount

Objeto de cuenta de almacenamiento

Type:	PSStorageAccount
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountName

Nombre de la cuenta de almacenamiento.

Type:	String
Aliases:	AccountName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

PSStorageAccount

PSShare

Salidas

Boolean