Share via

Get-AzStorageShare

  • Referens
Modul:
Az.Storage

Hämtar en lista över filresurser.

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

Cmdleten Get-AzStorageShare hämtar en lista över filresurser för ett lagringskonto.

Exempel

Exempel 1: Hämta en filresurs

Get-AzStorageShare -Name "ContosoShare06"

Det här kommandot hämtar filresursen med namnet ContosoShare06.

Exempel 2: Hämta alla filresurser som börjar med en sträng

Get-AzStorageShare -Prefix "Contoso"

Det här kommandot hämtar alla filresurser som har namn som börjar med Contoso.

Exempel 3: Hämta alla filresurser i en angiven kontext

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

Det första kommandot använder cmdleten New-AzStorageContext för att skapa en kontext med hjälp av parametern Lokal och lagrar sedan kontextobjektet i variabeln $Context. Det andra kommandot hämtar filresurserna för kontextobjektet som lagras i $Context.

Exempel 4: Hämta en ögonblicksbild av filresursen med ett specifikt resursnamn och SnapshotTime

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

Det här kommandot hämtar en ögonblicksbild av filresursen med specifikt resursnamn och SnapshotTime.

Exempel 5: Hämta ett filresursobjekt utan att hämta resursegenskaper med OAuth-autentisering.

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

Det här kommandot hämtar en ögonblicksbild av filresursen utan att hämta resursegenskaper med OAuth-autentisering. Det går inte att hämta resursegenskaper med OAuth-autentisering eftersom API:et inte stöder OAuth. Så för att hämta resursobjekt med OAuth-autentisering måste du hoppa över att hämta resursegenskaper.

Parametrar

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan i sekunder för en tjänstbegäran. Om det föregående anropet misslyckas i det angivna intervallet försöker den här cmdleten skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

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

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

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

-Context

Anger en Azure Storage-kontext. Om du vill hämta en kontext använder du cmdleten New-AzStorageContext .

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-IncludeDeleted

Inkludera borttagna resurser, som standard tar get-resursen inte med borttagna resurser

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

-Name

Anger namnet på filresursen. Den här cmdleten hämtar den filresurs som den här parametern anger, eller ingenting om du anger namnet på en filresurs som inte finns.

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

-Prefix

Anger prefixet för filresurser. Den här cmdleten hämtar filresurser som matchar prefixet som den här parametern anger, eller inga filresurser om inga filresurser matchar det angivna prefixet.

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

-ServerTimeoutPerRequest

Anger längden på tidsgränsen för serverdelen av en begäran.

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

-SkipGetProperty

Ange den här parametern för att endast generera ett lokalt resursobjekt, utan att hämta resursegenskaper från servern.

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

-SnapshotTime

SnapshotTime för den ögonblicksbild av filresursen som ska tas emot.

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

Indata

IStorageContext

Utdata

AzureStorageFileShare