az storage share-rm

Verwalten Sie Azure-Dateifreigaben mithilfe des Microsoft.Storage-Ressourcenanbieters.

Befehle

az storage share-rm create

Erstellen Sie eine neue Azure-Dateifreigabe unter dem angegebenen Speicherkonto.

az storage share-rm delete

Löschen Sie die angegebene Azure-Dateifreigabe oder -momentaufnahme.

az storage share-rm exists

Überprüfen Sie, ob eine Azure-Dateifreigabe vorhanden ist.

az storage share-rm list

Listet die Azure-Dateifreigaben unter dem angegebenen Speicherkonto auf.

az storage share-rm restore

Stellen Sie eine Dateifreigabe innerhalb eines gültigen Aufbewahrungszeitraums wieder her, wenn die Freigabe für das weiche Löschen aktiviert ist.

az storage share-rm show

Zeigen Sie die Eigenschaften für eine angegebene Azure-Dateifreigabe oder -momentaufnahme an.

az storage share-rm snapshot

Erstellen Sie eine Momentaufnahme einer vorhandenen Freigabe unter dem angegebenen Konto.

az storage share-rm stats

Rufen Sie die Nutzungsbytes der daten ab, die in der Freigabe gespeichert sind.

az storage share-rm update

Aktualisieren sie die Eigenschaften für eine Azure-Dateifreigabe.

az storage share-rm create

Erstellen Sie eine neue Azure-Dateifreigabe unter dem angegebenen Speicherkonto.

az storage share-rm create --name
                           --storage-account
                           [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                           [--enabled-protocols {NFS, SMB}]
                           [--metadata]
                           [--quota]
                           [--resource-group]
                           [--root-squash {AllSquash, NoRootSquash, RootSquash}]

Beispiele

Erstellen Sie eine neue Azure-Dateifreigabe "myfileshare" mit Metadaten und Kontingent als 10 GB unter dem Speicherkonto "mystorageaccount"(Kontoname) in der Ressourcengruppe "MyResourceGroup".

az storage share-rm create -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 10 --metadata key1=value1 key2=value2

Erstellen Sie eine neue Azure-Dateifreigabe "myfileshare" mit Metadaten und Kontingent als 6000 GB unter dem Speicherkonto "mystorageaccount"(Kontoname), der eine große Dateifreigabe in der Ressourcengruppe "MyResourceGroup" ermöglicht.

az storage account update -g MyResourceGroup --name mystorageaccount --enable-large-file-share
az storage share-rm create -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 6000 --metadata key1=value1 key2=value2

Erstellen Sie eine neue Azure-Dateifreigabe "myfileshare" mit Metadaten und Kontingent als 10 GB unter dem Speicherkonto "mystorageaccount" (Konto-ID).

az storage share-rm create --storage-account mystorageaccount --name myfileshare --quota 10 --metadata key1=value1 key2=value2

Erforderliche Parameter

--name -n

Der Dateifreigabename.

--storage-account

Der Name oder die ID des Speicherkontos.

Optionale Parameter

--access-tier

Zugriffsebene für bestimmte Freigaben. GpV2-Konto kann zwischen TransactionOptimized (Standard), Hot und Cool wählen. FileStorage-Konto kann Premium auswählen.

Zulässige Werte: Cool, Hot, Premium, TransactionOptimized
--enabled-protocols

Unveränderliche Eigenschaft für das Protokoll für Dateifreigaben. NFS-Protokoll ist nur für Premium-Dateifreigaben verfügbar (Dateifreigaben im FileStorage-Kontotyp).

Zulässige Werte: NFS, SMB
--metadata

Metadaten in leer getrennten Schlüssel=Wertpaaren, die der Freigabe zugeordnet sind. Dadurch werden alle vorhandenen Metadaten überschrieben.

--quota -q

Die maximale Größe des Anteils in Gigabyte. Muss größer als 0 und kleiner gleich 5 TB (5120) sein. Bei großen Dateifreigaben beträgt die maximale Größe 102400.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--root-squash

Reduzierung der Zugriffsrechte für den Remote-Superuser.

Zulässige Werte: AllSquash, NoRootSquash, RootSquash

az storage share-rm delete

Löschen Sie die angegebene Azure-Dateifreigabe oder -momentaufnahme.

UNTERBRECHUNGSÄNDERUNG: Die Momentaufnahme kann standardmäßig nicht gelöscht werden, und wir haben einen neuen Parameter hinzugefügt, der verwendet werden soll, wenn Sie Sanpshots für den Löschvorgang einschließen möchten.

az storage share-rm delete [--ids]
                           [--include]
                           [--name]
                           [--resource-group]
                           [--snapshot]
                           [--storage-account]
                           [--yes]

Beispiele

Löschen Sie eine Azure-Dateifreigabe "myfileshare" unter dem Speicherkonto "mystorageaccount" (Kontoname) in der Ressourcengruppe "MyResourceGroup".

az storage share-rm delete -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Löschen Sie eine Azure-Dateifreigabe "myfileshare" unter dem Speicherkonto "mystorageaccount" (Konto-ID).

az storage share-rm delete --storage-account mystorageaccount --name myfileshare

Löschen sie eine Azure-Dateifreigabe nach Ressourcen-ID.

az storage share-rm delete --ids file-share-id

Löschen einer Azure-Dateifreigabe-Momentaufnahme.

az storage share-rm delete --ids file-share-id --snapshot "2021-03-25T05:29:56.0000000Z"

Löschen Sie eine Azure-Dateifreigabe und alle ihre Momentaufnahmen.

az storage share-rm delete --include snapshots -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Löschen Sie eine Azure-Dateifreigabe und alle ihre Momentaufnahmen (geleaset/nicht freigegeben).

az storage share-rm delete --include leased-snapshots -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--include

Optional. Gültige Werte sind: Snapshots, leased-snapshots, none. Der Standardwert ist Momentaufnahmen. Bei "Momentaufnahmen" wird die Dateifreigabe gelöscht, einschließlich aller Momentaufnahmen der Dateifreigabe. Wenn die Dateifreigabe leased-Snapshots enthält, schlägt der Löschvorgang fehl. Für "leased-snapshots" wird die Dateifreigabe gelöscht, die alle Momentaufnahmen der Dateifreigabe enthält (geleast/unverleaset). Bei "none" wird die Dateifreigabe gelöscht, wenn keine Momentaufnahmen vorhanden sind. Wenn die Dateifreigabe Momentaufnahmen enthält (geleast oder nicht freigegeben), schlägt der Löschvorgang fehl.

Standardwert: none
--name -n

Der Dateifreigabename.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--snapshot

Der DateTime-Wert, der die abzurufende Freigabemomentaufnahme angibt.

--storage-account

Der Name oder die ID des Speicherkontos.

--yes -y

Nicht zur Bestätigung auffordern

az storage share-rm exists

Überprüfen Sie, ob eine Azure-Dateifreigabe vorhanden ist.

az storage share-rm exists [--ids]
                           [--name]
                           [--resource-group]
                           [--storage-account]

Beispiele

Überprüfen Sie, ob eine Azure-Dateifreigabe "myfileshare" unter dem Speicherkonto "mystorageaccount" (Kontoname) in der Ressourcengruppe "MyResourceGroup" vorhanden ist.

az storage share-rm exists -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Überprüfen Sie, ob eine Azure-Dateifreigabe "myfileshare" unter dem Speicherkonto "mystorageaccount" (Konto-ID) vorhanden ist.

az storage share-rm exists --storage-account mystorageaccount --name myfileshare

Überprüfen Sie, ob eine Azure-Dateifreigabe nach Ressourcen-ID vorhanden ist.

az storage share-rm exists --ids file-share-id

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Dateifreigabename.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--storage-account

Der Name oder die ID des Speicherkontos.

az storage share-rm list

Listet die Azure-Dateifreigaben unter dem angegebenen Speicherkonto auf.

az storage share-rm list --storage-account
                         [--include-deleted]
                         [--include-snapshot]
                         [--resource-group]

Beispiele

Auflisten der Azure-Dateifreigaben unter dem Speicherkonto "mystorageaccount" (Kontoname) in der Ressourcengruppe "MyResourceGroup".

az storage share-rm list -g MyResourceGroup --storage-account mystorageaccount

Auflisten der Azure-Dateifreigaben unter dem Speicherkonto "mystorageaccount" (Konto-ID).

az storage share-rm list --storage-account mystorageaccount

Alle Dateifreigaben werden unter dem Speicherkonto "mystorageaccount" gelöscht.

az storage share-rm list --storage-account mystorageaccount --include-deleted

Alle Dateifreigaben sind alle Momentaufnahmen unter dem Speicherkonto "mystorageaccount" enthalten.

az storage share-rm list --storage-account mystorageaccount --include-snapshot

Alle Dateifreigaben sind alle Momentaufnahmen und gelöschte Dateifreigaben unter dem Speicherkonto "mystorageaccount" enthalten.

az storage share-rm list --storage-account mystorageaccount --include-deleted --include-snapshot

Erforderliche Parameter

--storage-account

Der Name oder die ID des Speicherkontos.

Optionale Parameter

--include-deleted

Schließen Sie beim Angeben weich gelöschte Dateifreigaben ein.

--include-snapshot

Schließen Sie Momentaufnahmen der Dateifreigabe ein, wenn sie angegeben sind.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az storage share-rm restore

Wiederherstellen einer Dateifreigabe innerhalb eines gültigen Aufbewahrungszeitraums, wenn die Freigabe für die softe Löschung aktiviert ist.

az storage share-rm restore --deleted-version
                            [--ids]
                            [--name]
                            [--resource-group]
                            [--restored-name]
                            [--storage-account]

Beispiele

Stellen Sie eine Dateifreigabe innerhalb eines gültigen Aufbewahrungszeitraums wieder her, wenn die Freigabe für das weiche Löschen aktiviert ist.

az storage share-rm restore -n deletedshare --deleted-version 01D64EB9886F00C4 -g MyResourceGroup --storage-account mystorageaccount

Stellen Sie eine Dateifreigabe innerhalb eines gültigen Aufbewahrungszeitraums wieder her, wenn die Freigabe für das soft delete auf einen neuen Namen aktiviert ist.

az storage share-rm restore -n deletedshare --deleted-version 01D64EB9886F00C4 --restored-name newname -g MyResourceGroup --storage-account mystorageaccount

Erforderliche Parameter

--deleted-version

Identifizieren Sie die Version der gelöschten Freigabe, die wiederhergestellt wird.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Dateifreigabename. Identifizieren Sie den Namen der gelöschten Freigabe, die wiederhergestellt wird.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--restored-name

Ein neuer Dateifreigabename, der wiederhergestellt werden soll. Wenn nicht angegeben, werden gelöschte Freigabenamen verwendet.

--storage-account

Der Name oder die ID des Speicherkontos.

az storage share-rm show

Zeigen Sie die Eigenschaften für eine angegebene Azure-Dateifreigabe oder eine Momentaufnahme an.

az storage share-rm show [--expand]
                         [--ids]
                         [--name]
                         [--resource-group]
                         [--snapshot]
                         [--storage-account]

Beispiele

Zeigen Sie die Eigenschaften für eine Azure-Dateifreigabe "myfileshare" unter dem Speicherkonto "mystorageaccount" (Kontoname) in der Ressourcengruppe "MyResourceGroup" an.

az storage share-rm show -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Zeigen Sie die Eigenschaften für eine Azure-Dateifreigabe "myfileshare" unter dem Speicherkonto "mystorageaccount" (Konto-ID) an.

az storage share-rm show --storage-account mystorageaccount --name myfileshare

Zeigen Sie die Eigenschaften einer Azure-Dateifreigabe nach Ressourcen-ID an.

az storage share-rm show --ids file-share-id

Anzeigen der Eigenschaften einer Azure-Dateifreigabe-Momentaufnahme

az storage share-rm show --ids file-share-id --snapshot "2021-03-25T05:29:56.0000000Z"

Optionale Parameter

--expand

Optional, verwendet, um die Eigenschaften innerhalb der Eigenschaften der Freigabe zu erweitern. Gültige Werte sind: Statistiken. Sollte als Zeichenfolge mit Trennzeichen '',' übergeben werden.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Dateifreigabename.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--snapshot

Der DateTime-Wert, der die Freigabeaufnahme angibt, die abgerufen werden soll.

--storage-account

Der Name oder die ID des Speicherkontos.

az storage share-rm snapshot

Erstellen Sie eine Momentaufnahme einer vorhandenen Freigabe unter dem angegebenen Konto.

az storage share-rm snapshot [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                             [--enabled-protocols {NFS, SMB}]
                             [--ids]
                             [--metadata]
                             [--name]
                             [--quota]
                             [--resource-group]
                             [--root-squash {AllSquash, NoRootSquash, RootSquash}]
                             [--storage-account]

Beispiele

Erstellen Sie eine Momentaufnahme einer vorhandenen Freigabe unter dem angegebenen Konto.

az storage share-rm snapshot -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Optionale Parameter

--access-tier

Access-Ebene für bestimmte Freigaben. GpV2-Konto kann zwischen TransactionOptimized (Standard), Hot und Cool wählen. FileStorage-Konto kann Premium auswählen.

Zulässige Werte: Cool, Hot, Premium, TransactionOptimized
--enabled-protocols

Unveränderliche Eigenschaft für das Protokoll für Dateifreigaben. NFS-Protokoll ist nur für Premium-Dateifreigaben verfügbar (Dateifreigaben im DateiStorage-Kontotyp).

Zulässige Werte: NFS, SMB
--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--metadata

Metadaten in leer getrennten Schlüssel=Wertpaaren, die der Freigabe zugeordnet sind. Dadurch werden alle vorhandenen Metadaten überschrieben.

--name -n

Der Dateifreigabename.

--quota -q

Die maximale Größe der Freigabe in Gigabytes. Muss größer als 0 und kleiner gleich 5 TB (5120) sein. Für große Dateifreigaben beträgt die maximale Größe 102400.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--root-squash

Verringerung der Zugriffsrechte für den Remote-Superuser.

Zulässige Werte: AllSquash, NoRootSquash, RootSquash
--storage-account

Der Name oder die ID des Speicherkontos.

az storage share-rm stats

Rufen Sie die Nutzungsbytes der auf der Freigabe gespeicherten Daten ab.

az storage share-rm stats [--ids]
                          [--name]
                          [--resource-group]
                          [--storage-account]

Beispiele

Rufen Sie die Nutzungsbytes der auf der Freigabe gespeicherten Daten ab.

az storage share-rm stats -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Der Dateifreigabename.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--storage-account

Der Name oder die ID des Speicherkontos.

az storage share-rm update

Aktualisieren Sie die Eigenschaften für eine Azure-Dateifreigabe.

az storage share-rm update [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                           [--add]
                           [--force-string]
                           [--ids]
                           [--metadata]
                           [--name]
                           [--quota]
                           [--remove]
                           [--resource-group]
                           [--root-squash {AllSquash, NoRootSquash, RootSquash}]
                           [--set]
                           [--storage-account]

Beispiele

Aktualisieren Sie die Eigenschaften für eine Azure-Dateifreigabe "myfileshare" unter dem Speicherkonto "mystorageaccount" (Kontoname) in der Ressourcengruppe "MyResourceGroup".

az storage share-rm update -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 3 --metadata key1=value1 key2=value2

Aktualisieren Sie die Eigenschaften für eine Azure-Dateifreigabe "myfileshare" unter dem Speicherkonto "mystorageaccount" (Konto-ID).

az storage share-rm update --storage-account mystorageaccount --name myfileshare --quota 3 --metadata key1=value1 key2=value2

Aktualisieren Sie die Eigenschaften für eine Azure-Dateifreigabe nach Ressourcen-ID.

az storage share-rm update --ids file-share-id --quota 3 --metadata key1=value1 key2=value2

Optionale Parameter

--access-tier

Access-Ebene für bestimmte Freigaben. GpV2-Konto kann zwischen TransactionOptimized (Standard), Hot und Cool wählen. FileStorage-Konto kann Premium auswählen.

Zulässige Werte: Cool, Hot, Premium, TransactionOptimized
--add

Fügen Sie einem Objekt eine Liste von Objekten hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgen literale beibehalten, anstatt zu versuchen, in JSON zu konvertieren.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--metadata

Metadaten in leer getrennten Schlüssel=Wertpaaren, die der Freigabe zugeordnet sind. Dadurch werden alle vorhandenen Metadaten überschrieben.

--name -n

Der Dateifreigabename.

--quota -q

Die maximale Größe der Freigabe in Gigabytes. Muss größer als 0 und kleiner gleich 5 TB (5120) sein. Für große Dateifreigaben beträgt die maximale Größe 102400.

--remove

Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--root-squash

Verringerung der Zugriffsrechte für den Remote-Superuser.

Zulässige Werte: AllSquash, NoRootSquash, RootSquash
--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.

--storage-account

Der Name oder die ID des Speicherkontos.