Freigeben über

Get-AzStorageShare

  • Referenz
Modul:
Az.Storage

Ruft eine Liste der Dateifreigaben ab.

Syntax

Get-AzStorageShare
   [[-Prefix] <String>]
   [-IncludeDeleted]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageShare
   [-Name] <String>
   [[-SnapshotTime] <DateTimeOffset>]
   [-SkipGetProperty]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-AzStorageShare " ruft eine Liste der Dateifreigaben für ein Speicherkonto ab.

Beispiele

Beispiel 1: Abrufen einer Dateifreigabe

Get-AzStorageShare -Name "ContosoShare06"

Dieser Befehl ruft die Dateifreigabe mit dem Namen ContosoShare06 ab.

Beispiel 2: Abrufen aller Dateifreigaben, die mit einer Zeichenfolge beginnen

Get-AzStorageShare -Prefix "Contoso"

Dieser Befehl ruft alle Dateifreigaben ab, die namen haben, die mit Contoso beginnen.

Beispiel 3: Abrufen aller Dateifreigaben in einem bestimmten Kontext

$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $Context

Der erste Befehl verwendet das Cmdlet New-AzStorageContext , um einen Kontext mithilfe des Local-Parameters zu erstellen, und speichert dieses Kontextobjekt dann in der $Context Variablen. Der zweite Befehl ruft die Dateifreigaben für das kontextobjekt ab, das in $Context gespeichert ist.

Beispiel 4: Abrufen einer Dateifreigabemomentaufnahme mit einem bestimmten Freigabenamen und SnapshotTime

Get-AzStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

Dieser Befehl ruft eine Momentaufnahme der Dateifreigabe mit einem bestimmten Freigabenamen und SnapshotTime ab.

Beispiel 5: Abrufen eines Dateifreigabeobjekts ohne Abrufen von Freigabeeigenschaften mit OAuth-Authentifizierung.

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
$share = Get-AzStorageShare -Name "ContosoShare06" -SkipGetProperty -Context $ctx

Dieser Befehl ruft eine Momentaufnahme der Dateifreigabe ab, ohne Freigabeeigenschaften mit der OAuth-Authentifizierung abzurufen. Das Abrufen von Freigabeeigenschaften mit der OAuth-Authentifizierung schlägt fehl, da die API OAuth nicht unterstützt. Um also ein Freigabeobjekt mit der OAuth-Authentifizierung abzurufen, muss das Abrufen von Freigabeeigenschaften übersprungen werden.

Parameter

-ClientTimeoutPerRequest

Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.

Typ:Nullable<T>[Int32]
Aliase:ClientTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConcurrentTaskCount

Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert lautet 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Context

Gibt einen Azure Storage-Kontext an. Verwenden Sie zum Abrufen eines Kontexts das Cmdlet New-AzStorageContext .

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

-IncludeDeleted

Gelöschte Freigaben einschließen, standardmäßig werden gelöschte Freigaben nicht eingeschlossen.

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

-Name

Gibt den Namen der Dateifreigabe an. Dieses Cmdlet ruft die Dateifreigabe ab, die dieser Parameter angibt, oder nichts, wenn Sie den Namen einer Dateifreigabe angeben, die nicht vorhanden ist.

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

-Prefix

Gibt das Präfix für Dateifreigaben an. Dieses Cmdlet ruft Dateifreigaben ab, die dem Präfix entsprechen, das dieser Parameter angibt, oder keine Dateifreigaben, wenn keine Dateifreigaben mit dem angegebenen Präfix übereinstimmen.

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

-ServerTimeoutPerRequest

Gibt die Länge des Timeoutzeitraums für den Serverteil einer Anforderung an.

Typ:Nullable<T>[Int32]
Aliase:ServerTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipGetProperty

Geben Sie diesen Parameter an, um nur ein lokales Freigabeobjekt zu generieren, ohne Freigabeeigenschaften vom Server abzurufen.

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

-SnapshotTime

SnapshotTime der zu empfangenden Momentaufnahme der Dateifreigabe.

Typ:Nullable<T>[DateTimeOffset]
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

IStorageContext

Ausgaben

AzureStorageFileShare