Dela 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 Local 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.

Typ:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Context

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

Typ:IStorageContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeDeleted

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServerTimeoutPerRequest

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

Typ:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkipGetProperty

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SnapshotTime

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

Typ:Nullable<T>[DateTimeOffset]
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

IStorageContext

Utdata

AzureStorageFileShare