Remove-AzRmStorageShare

Référence

Module:: Az.Storage

Supprime un partage de fichiers de stockage.

Syntaxe

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

L’applet de commande New-AzRmStorageShare supprime un partage de fichiers de stockage.

Exemples

Exemple 1 : Supprimer un partage de fichiers de stockage avec le nom du compte de stockage et le nom du partage

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

Cette commande supprime un partage de fichiers de stockage avec le nom du compte de stockage et le nom du partage.

Exemple 2 : Supprimer un partage de fichiers de stockage avec un objet de compte de stockage et un nom de partage

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

Cette commande supprime un partage de fichiers de stockage avec un objet de compte de stockage et un nom de partage.

Exemple 3 : Supprimer tous les partages de fichiers de stockage dans un compte de stockage avec pipeline

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

Cette commande supprime tous les partages de fichiers de stockage dans un compte de stockage avec pipeline.

Exemple 4 : Supprimer un instantané de partage de fichiers de stockage unique

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

Cette commande supprime un instantané de partage de fichiers de stockage unique avec le nom de partage et l’heure d’instantané spécifiques

Exemple 5 : Supprimer un partage de fichiers de stockage et ses instantanés

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

Cette commande supprime un partage de fichiers de stockage et les captures instantanées Par défaut, l’applet de commande échoue si le partage de fichiers comporte des instantanés sans paramètre « -include ».

Exemple 6 : Supprimer un partage de fichiers de stockage et tous ses instantanés (inclure des instantanés loués)

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

Cette commande supprime un partage de fichiers de stockage et tous ses instantanés, y compris les instantanés loués et non loués. Par défaut, l’applet de commande échoue si le partage de fichiers a des instantanés sans paramètre « -include ».

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Force

Forcer la suppression du partage (instantané) et de tout le contenu dans celui-ci

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Include

Les valeurs valides sont les suivantes : instantanés, instantanés loués, aucun. La valeur par défaut n’est pas. Pour « aucun », le partage de fichiers est supprimé s’il n’a aucun instantané de partage. Si le partage de fichiers contient des instantanés (loués ou non générés), la suppression échoue. Pour « captures instantanées », le partage de fichiers est supprimé, y compris tous ses instantanés de partage de fichiers. Si le partage de fichiers contient des instantanés loués, la suppression échoue. Pour les « captures instantanées louées », le partage de fichiers est supprimé, y compris tous ses instantanés de partage de fichiers (loués/ non légés).

Type:	String
Valeurs acceptées:	None, Snapshots, Leased-Snapshots
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Objet De partage de stockage

Type:	PSShare
Alias:	Share
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

Nom du partage

Type:	String
Alias:	N, ShareName
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PassThru

Indique que cette applet de commande retourne une valeur booléenne qui reflète la réussite de l’opération. Par défaut, cette applet de commande ne retourne pas de valeur.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceGroupName

Nom du groupe de ressources.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceId

Entrez un ID de ressource de partage de fichiers.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-SnapshotTime

Partager SnapshotTime

Type:	Nullable<T>[DateTime]
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-StorageAccount

Objet compte de stockage

Type:	PSStorageAccount
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-StorageAccountName

Nom du compte de stockage.

Type:	String
Alias:	AccountName
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

PSStorageAccount

PSShare

Sorties

Boolean

Partager via