Get-AzStorageShare

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

Syntax

MatchingPrefix (Výchozí)

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

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.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ClientTimeoutPerRequestInSeconds

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Context

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

Vlastnosti parametru

Typ:IStorageContext
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

MatchingPrefix
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Specific
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

MatchingPrefix
Position:0
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ServerTimeoutPerRequest

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

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ServerTimeoutPerRequestInSeconds

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Specific
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SnapshotTime

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

Vlastnosti parametru

Typ:

Nullable<T>[DateTimeOffset]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Specific
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

IStorageContext

Výstupy

AzureStorageFileShare