Freigeben über


Rename-AzStorageDirectory

Benennt ein Verzeichnis um.

Syntax

Rename-AzStorageDirectory
      [-ShareName] <String>
      [-SourcePath] <String>
      [[-DestinationPath] <String>]
      [-Permission <String>]
      [-DisAllowSourceTrailingDot]
      [-DisAllowDestTrailingDot]
      [-Force]
      [-AsJob]
      [-Context <IStorageContext>]
      [-DefaultProfile <IAzureContextContainer>]
      [-IgnoreReadonly]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Rename-AzStorageDirectory
      [-ShareClient] <ShareClient>
      [-SourcePath] <String>
      [[-DestinationPath] <String>]
      [-Permission <String>]
      [-Force]
      [-AsJob]
      [-Context <IStorageContext>]
      [-DefaultProfile <IAzureContextContainer>]
      [-IgnoreReadonly]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Rename-AzStorageDirectory
      [-ShareDirectoryClient] <ShareDirectoryClient>
      [[-DestinationPath] <String>]
      [-Permission <String>]
      [-Force]
      [-AsJob]
      [-Context <IStorageContext>]
      [-DefaultProfile <IAzureContextContainer>]
      [-IgnoreReadonly]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Rename-AzStorageDirectory benennt ein Verzeichnis aus einer Dateifreigabe um.

Beispiele

Beispiel 1: Umbenennen eines Verzeichnisses

Rename-AzStorageDirectory -ShareName myshare -SourcePath testdir1 -DestinationPath testdir2

Directory: https://myaccount.file.core.windows.net/myshare

Type                Length Name
----                ------ ----
Directory                1 testdir2

Mit diesem Befehl wird ein Verzeichnis von "testdir1" in "testdir2" umbenannt.

Beispiel 2: Umbenennen eines Verzeichnisses mithilfe der Pipeline

Get-AzStorageFile -ShareName myshare -Path testdir1 | Rename-AzStorageDirectory -DestinationPath testdir2

Directory: https://myaccount.file.core.windows.net/myshare

Type                Length Name
----                ------ ----
Directory                1 testdir2

Dieser Befehl ruft zuerst ein Verzeichnis aus einer Dateifreigabe ab, und benennen Sie dann das Verzeichnis von testdir1 in testdir2 mithilfe der Pipeline um.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Context

Azure Storage Context-Objekt

Typ:IStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DestinationPath

Der Zielpfad zum Umbenennen des Verzeichnisses in.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisAllowDestTrailingDot

Zulassen des nachfolgenden Punkts (.) zum Suffix des Zielverzeichnisses und der Zieldateinamen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisAllowSourceTrailingDot

Verbieten Sie nachgestellten Punkt (.) das Suffix des Quellverzeichnisses und der Quelldateinamen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingen, die vorhandene Datei zu überschreiben.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IgnoreReadonly

Optional. Gibt an, ob das ReadOnly-Attribut für eine bereits vorhandene Zieldatei berücksichtigt werden soll. Wenn true, wird die Umbenennung erfolgreich ausgeführt, andernfalls führt eine vorherige Datei am Ziel mit dem ReadOnly-Attributsatz dazu, dass die Umbenennung fehlschlägt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Permission

Wenn angegeben, muss die Berechtigung (Sicherheitsbeschreibung) für das Verzeichnis/die Datei festgelegt werden. Standardwert: Erben. Wenn SDDL als Eingabe angegeben wird, muss sie besitzer, gruppieren und dacl haben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ShareClient

ShareClienr hat die Freigabe angegeben, in der das Verzeichnis aufgeführt wäre.

Typ:ShareClient
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShareDirectoryClient

Quellverzeichnisinstanz

Typ:ShareDirectoryClient
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShareName

Name der Dateifreigabe, in der das Verzeichnis aufgelistet würde.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SourcePath

Pfad zu einem vorhandenen Verzeichnis.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

ShareClient

ShareDirectoryClient

IStorageContext

Ausgaben

AzureStorageFileDirectory