Get-AzStorageShare

  • Referencia
Modul:
Az.Storage

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

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

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.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

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

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SnapshotTime

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

Type:Nullable<T>[DateTimeOffset]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

IStorageContext

Kimenetek

AzureStorageFileShare