Dela via

Get-AzStorageShare

Modul:
Az.Storage Module

Hämtar en lista över filresurser.

Syntax

MatchingPrefix (Standard) 

Get-AzStorageShare
    [[-Prefix] <String>]
    [-IncludeDeleted]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Specific 

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.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Context

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

Parameteregenskaper

Typ:IStorageContext
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IncludeDeleted

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

MatchingPrefix
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Specific
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

MatchingPrefix
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ServerTimeoutPerRequest

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

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SkipGetProperty

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Specific
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SnapshotTime

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

Parameteregenskaper

Typ:

Nullable<T>[DateTimeOffset]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Specific
Position:1
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

IStorageContext

Utdata

AzureStorageFileShare