Get-AzStorageShare

  • Referentie
Module:
Az.Storage

Hiermee haalt u een lijst met bestandsshares op.

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

Description

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

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 maakt gebruik van 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]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

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

-IncludeDeleted

Verwijderde shares opnemen, standaard worden verwijderde shares niet opgenomen

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

-ServerTimeoutPerRequest

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

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

-SnapshotTime

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

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

Invoerwaarden

IStorageContext

Uitvoerwaarden

AzureStorageFileShare