Delen via

Get-AzStorageShare

  • Referentie
Module:
Az.Storage

Hiermee haalt u een lijst met bestandsshares op.

Syntaxis

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>]

Description

De cmdlet Get-AzStorageShare haalt een lijst met bestandsshares voor een opslagaccount op.

Voorbeelden

Voorbeeld 1: Een bestandsshare ophalen

Get-AzStorageShare -Name "ContosoShare06"

Met deze opdracht wordt de bestandsshare met de naam ContosoShare06 ophaalt.

Voorbeeld 2: alle bestandsshares ophalen die beginnen met een tekenreeks

Get-AzStorageShare -Prefix "Contoso"

Met deze opdracht worden alle bestandsshares met namen opgeslagen die beginnen met Contoso.

Voorbeeld 3: alle bestandsshares ophalen in een opgegeven context

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

De eerste opdracht gebruikt de cmdlet New-AzStorageContext om een context te maken met behulp van de parameter Local en slaat dat contextobject vervolgens op in de $Context variabele. Met de tweede opdracht worden de bestandsshares opgehaald voor het contextobject dat is opgeslagen in $Context.

Voorbeeld 4: Een momentopname van een bestandsshare ophalen met een specifieke sharenaam en SnapshotTime

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

Met deze opdracht haalt u een momentopname van een bestandsshare op met een specifieke sharenaam en SnapshotTime.

Voorbeeld 5: Een bestandsshareobject ophalen zonder shareeigenschappen op te halen met OAuth-verificatie.

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

Met deze opdracht wordt een momentopname van een bestandsshare opgevraagd zonder shareeigenschappen op te halen met OAuth-verificatie. Het ophalen van shareeigenschappen met OAuth-verificatie mislukt omdat de API OAuth niet ondersteunt. Als u een shareobject wilt ophalen met OAuth-verificatie, moet u de eigenschappen van de share overslaan.

Parameters

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

Type:Nullable<T>[Int32]
Aliassen:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Hiermee geeft u een Azure Storage-context op. Gebruik de cmdlet New-AzStorageContext om een context te verkrijgen.

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IncludeDeleted

Verwijderde shares opnemen, standaard worden verwijderde shares niet opgenomen

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de bestandsshare. Deze cmdlet haalt de bestandsshare op die met deze parameter wordt opgegeven of niets als u de naam opgeeft van een bestandsshare die niet bestaat.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Prefix

Hiermee geeft u het voorvoegsel voor bestandsshares. Deze cmdlet haalt bestandsshares op die overeenkomen met het voorvoegsel dat met deze parameter wordt opgegeven, of geen bestandsshares als er geen bestandsshares overeenkomen met het opgegeven voorvoegsel.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServerTimeoutPerRequest

Hiermee geeft u de lengte van de time-outperiode voor het serveronderdeel van een aanvraag.

Type:Nullable<T>[Int32]
Aliassen:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipGetProperty

Geef deze parameter op om alleen een lokaal shareobject te genereren, zonder shareeigenschappen van de server op te halen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SnapshotTime

SnapshotTime van de momentopname van de bestandsshare die moet worden ontvangen.

Type:Nullable<T>[DateTimeOffset]
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uitvoerwaarden