Share via

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 Dateifreigabe Momentaufnahme mit einem bestimmten Freigabenamen und SnapshotTime

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

Dieser Befehl ruft eine Dateifreigabe Momentaufnahme 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 Dateifreigabe Momentaufnahme ab, ohne Eigenschaften für die 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.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 ist 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

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

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipGetProperty

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SnapshotTime

SnapshotTime der zu empfangenden Dateifreigabe Momentaufnahme.

Type:Nullable<T>[DateTimeOffset]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

IStorageContext

Ausgaben

AzureStorageFileShare