Get-AzStorageShare

  • Reference
Modul:
Az.Storage

Získá seznam sdílených složek.

Syntaxe

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

Rutina Get-AzStorageShare získá seznam sdílených složek pro účet úložiště.

Příklady

Příklad 1: Získání sdílené složky

Get-AzStorageShare -Name "ContosoShare06"

Tento příkaz získá sdílenou složku s názvem ContosoShare06.

Příklad 2: Získání všech sdílených složek, které začínají řetězcem

Get-AzStorageShare -Prefix "Contoso"

Tento příkaz získá všechny sdílené složky, které mají názvy začínající společností Contoso.

Příklad 3: Získání všech sdílených složek v zadaném kontextu

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

První příkaz pomocí rutiny New-AzStorageContext vytvoří kontext pomocí místního parametru a pak tento objekt kontextu uloží do proměnné $Context. Druhý příkaz získá sdílené složky pro kontextový objekt uložený v $Context.

Příklad 4: Získání snímku sdílené složky s konkrétním názvem sdílené složky a snímkemTime

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

Tento příkaz získá snímek sdílené složky s konkrétním názvem sdílené složky a snímkemTime.

Příklad 5: Získání objektu sdílené složky bez načtení vlastností sdílené složky pomocí ověřování OAuth

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

Tento příkaz získá snímek sdílené složky bez získání vlastností sdílené složky s ověřováním OAuth. Získání vlastností sdílení s ověřováním OAuth selže, protože rozhraní API nepodporuje OAuth. Aby bylo nutné získat objekt sdílené složky s ověřováním OAuth, musí přeskočit vlastnosti načtení sdílené složky.

Parametry

-ClientTimeoutPerRequest

Určuje interval časového limitu na straně klienta v sekundách pro jednu žádost o službu. Pokud předchozí volání v zadaném intervalu selže, tato rutina požadavek opakuje. Pokud tato rutina neobdrží úspěšnou odpověď před uplynutím intervalu, vrátí tato rutina chybu.

Typ:Nullable<T>[Int32]
Aliasy:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ConcurrentTaskCount

Určuje maximální počet souběžných síťových volání. Pomocí tohoto parametru můžete omezit souběžnost na omezení využití místního procesoru a šířky pásma zadáním maximálního počtu souběžných síťových volání. Zadaná hodnota je absolutní počet a nevynásobí se počtem jader. Tento parametr může pomoct snížit problémy s připojením k síti v prostředích s nízkou šířkou pásma, například 100 kilobitů za sekundu. Výchozí hodnota je 10.

Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Context

Určuje kontext služby Azure Storage. K získání kontextu použijte rutinu New-AzStorageContext .

Typ:IStorageContext
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IncludeDeleted

Zahrnout odstraněné sdílené složky, ve výchozím nastavení sdílená složka nebude obsahovat odstraněné sdílené složky.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název sdílené složky. Tato rutina získá sdílenou složku, kterou tento parametr určuje, nebo nic, pokud zadáte název sdílené složky, která neexistuje.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Prefix

Určuje předponu pro sdílené složky. Tato rutina získá sdílené složky, které odpovídají předponě, kterou tento parametr určuje, nebo žádné sdílené složky, pokud se žádné sdílené složky neshoduje se zadanou předponou.

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerTimeoutPerRequest

Určuje délku časového limitu pro část požadavku serveru.

Typ:Nullable<T>[Int32]
Aliasy:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipGetProperty

Tento parametr zadejte, pokud chcete vygenerovat pouze objekt místní sdílené složky bez získání vlastností sdílené složky ze serveru.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SnapshotTime

SnapshotTime snímku sdílené složky, který se má přijímat.

Typ:Nullable<T>[DateTimeOffset]
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

IStorageContext

Výstupy

AzureStorageFileShare