Remove-AzRmStorageShare

Módulo:

Az.Storage Module

Quita un recurso compartido de archivos de almacenamiento.

Sintaxis

AccountName (valor predeterminado)

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

AccountNameSnapshot

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

AccountObject

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

AccountObjectSnapshot

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

ShareResourceId

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

ShareObject

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

Description

El cmdlet Remove-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 pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DefaultProfile

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

Propiedades de parámetro

Tipo:	IAzureContextContainer
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Force

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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).

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Valores aceptados:	None, Snapshots, Leased-Snapshots
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

AccountName

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountObject

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

ShareResourceId

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

ShareObject

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-InputObject

Storage Share (objeto)

Propiedades de parámetro

Tipo:	PSShare
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Compartir

Conjuntos de parámetros

ShareObject

Posición:	Named
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Name

Nombre del recurso compartido

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	N, ShareName

Conjuntos de parámetros

AccountName

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountNameSnapshot

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountObject

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountObjectSnapshot

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

AccountName

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountNameSnapshot

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ResourceId

Escriba un identificador de recurso del recurso compartido de archivos.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ShareResourceId

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-SnapshotTime

Uso compartido de SnapshotTime

Propiedades de parámetro

Tipo:	Nullable<T>[DateTime]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

AccountNameSnapshot

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountObjectSnapshot

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StorageAccount

Objeto de cuenta de almacenamiento

Propiedades de parámetro

Tipo:	PSStorageAccount
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

AccountObject

Posición:	Named
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountObjectSnapshot

Posición:	Named
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StorageAccountName

Nombre de la cuenta de almacenamiento.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Nombre de la cuenta

Conjuntos de parámetros

AccountName

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountNameSnapshot

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

PSStorageAccount

PSShare

Salidas

Boolean