Get-AzStorageShare

Modul:
Az.Storage Module

Lekéri a fájlmegosztások listáját.

Syntax

MatchingPrefix (Alapértelmezett) 

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

A Get-AzStorageShare parancsmag lekéri egy tárfiók fájlmegosztásainak listáját.

Példák

1. példa: Fájlmegosztás lekérése

Get-AzStorageShare -Name "ContosoShare06"

Ez a parancs lekéri a ContosoShare06 nevű fájlmegosztást.

2. példa: Az összes sztringgel kezdődő fájlmegosztás lekérése

Get-AzStorageShare -Prefix "Contoso"

Ez a parancs lekéri az összes olyan fájlmegosztást, amelynek neve Contoso-val kezdődik.

3. példa: Az összes fájlmegosztás lekérése egy adott környezetben

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

Az első parancs a New-AzStorageContext parancsmaggal hoz létre egy környezetet a Local paraméterrel, majd a környezeti objektumot a $Context változóban tárolja. A második parancs lekéri a $Context tárolt környezeti objektum fájlmegosztásait.

4. példa: Fájlmegosztás pillanatképének lekérése adott megosztásnévvel és SnapshotTime-tal

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

Ez a parancs lekéri a fájlmegosztás pillanatképét adott megosztás nevével és SnapshotTime-jával.

5. példa: Fájlmegosztási objektum lekérése oAuth-hitelesítéssel a megosztási tulajdonságok lekérése nélkül.

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

Ez a parancs oAuth-hitelesítéssel rendelkező megosztási tulajdonságok lekérése nélkül lekéri a fájlmegosztás pillanatképét. A megosztási tulajdonságok OAuth-hitelesítéssel való lekérése sikertelen lesz, mivel az API nem támogatja az OAuth-ot. A megosztási objektum OAuth-hitelesítéssel való lekéréséhez tehát nem kell lekérni a megosztási tulajdonságokat.

Paraméterek

-ClientTimeoutPerRequest

Egy szolgáltatáskérés ügyféloldali időtúllépési időközét adja meg másodpercben. Ha az előző hívás a megadott időközönként meghiúsul, a parancsmag újrapróbálkozza a kérést. Ha ez a parancsmag nem kap sikeres választ az időköz eltelte előtt, ez a parancsmag hibát ad vissza.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:ClientTimeoutPerRequestInSeconds

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ConcurrentTaskCount

Az egyidejű hálózati hívások maximális száma. Ezzel a paramétersel korlátozhatja az egyidejűséget a helyi processzor- és sávszélesség-használat szabályozására az egyidejű hálózati hívások maximális számának megadásával. A megadott érték abszolút szám, és nem szorozza meg a magok számával. Ez a paraméter segíthet csökkenteni a hálózati csatlakozási problémákat alacsony sávszélességű környezetekben, például másodpercenként 100 kilobitben. Az alapértelmezett érték 10.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Context

Egy Azure Storage-környezetet határoz meg. Környezet beszerzéséhez használja a New-AzStorageContext parancsmagot.

Paramétertulajdonságok

Típus:IStorageContext
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:AzureRmContext, AzureCredential

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-IncludeDeleted

Törölt megosztások belefoglalása, alapértelmezés szerint a megosztás lekérése nem tartalmazza a törölt megosztásokat

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

MatchingPrefix
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Name

Megadja a fájlmegosztás nevét. Ez a parancsmag lekéri a paraméter által megadott fájlmegosztást, vagy semmit, ha megadja a nem létező fájlmegosztás nevét.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Specific
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Prefix

Megadja a fájlmegosztások előtagjait. Ez a parancsmag olyan fájlmegosztásokat kap, amelyek megfelelnek a paraméter által megadott előtagnak, vagy nem lesznek fájlmegosztások, ha egyetlen fájlmegosztás sem felel meg a megadott előtagnak.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

MatchingPrefix
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ServerTimeoutPerRequest

A kérelem kiszolgálói részének időtúllépési időtartamát adja meg.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:ServerTimeoutPerRequestInSeconds

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SkipGetProperty

Ezt a paramétert úgy adhatja meg, hogy csak helyi megosztási objektumot hozzon létre anélkül, hogy a kiszolgálótól lekérheti a megosztási tulajdonságokat.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Specific
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SnapshotTime

A fogadandó fájlmegosztás pillanatképének Pillanatképe.

Paramétertulajdonságok

Típus:

Nullable<T>[DateTimeOffset]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Specific
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

IStorageContext

Kimenetek

AzureStorageFileShare