Get-AzStorageShare
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.
Típus: | Nullable<T>[Int32] |
Aliasok: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Nullable<T>[Int32] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Context
Egy Azure Storage-környezetet határoz meg. Környezet beszerzéséhez használja a New-AzStorageContext parancsmagot.
Típus: | IStorageContext |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ServerTimeoutPerRequest
A kérelem kiszolgálói részének időtúllépési időtartamát adja meg.
Típus: | Nullable<T>[Int32] |
Aliasok: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-SnapshotTime
A fogadandó fájlmegosztás pillanatképének Pillanatképe.
Típus: | Nullable<T>[DateTimeOffset] |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |