Udostępnij za pośrednictwem

Get-AzStorageShare

  • Odwołanie
Moduł:
Az.Storage

Pobiera listę udziałów plików.

Składnia

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>]

Opis

Polecenie cmdlet Get-AzStorageShare pobiera listę udziałów plików dla konta magazynu.

Przykłady

Przykład 1. Pobieranie udziału plików

Get-AzStorageShare -Name "ContosoShare06"

To polecenie pobiera udział plików o nazwie ContosoShare06.

Przykład 2. Pobieranie wszystkich udziałów plików rozpoczynających się od ciągu

Get-AzStorageShare -Prefix "Contoso"

To polecenie pobiera wszystkie udziały plików, które mają nazwy rozpoczynające się od firmy Contoso.

Przykład 3. Pobieranie wszystkich udziałów plików w określonym kontekście

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

Pierwsze polecenie używa polecenia cmdlet New-AzStorageContext do utworzenia kontekstu przy użyciu parametru lokalnego, a następnie przechowuje ten obiekt kontekstu w zmiennej $Context. Drugie polecenie pobiera udziały plików dla obiektu kontekstu przechowywanego w $Context.

Przykład 4. Pobieranie migawki udziału plików z określoną nazwą udziału i migawkąTime

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

To polecenie pobiera migawkę udziału plików o określonej nazwie udziału i SnapshotTime.

Przykład 5. Pobieranie obiektu udziału plików bez pobierania właściwości udziału przy użyciu uwierzytelniania OAuth.

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

To polecenie pobiera migawkę udziału plików bez uzyskiwania właściwości udziału przy użyciu uwierzytelniania OAuth. Pobieranie właściwości udostępniania przy użyciu uwierzytelniania OAuth zakończy się niepowodzeniem, ponieważ interfejs API nie obsługuje protokołu OAuth. Aby uzyskać obiekt udostępniania przy użyciu uwierzytelniania OAuth, należy pominąć pobieranie właściwości udziału.

Parametry

-ClientTimeoutPerRequest

Określa interwał limitu czasu po stronie klienta w sekundach dla jednego żądania obsługi. Jeśli poprzednie wywołanie zakończy się niepowodzeniem w określonym interwale, to polecenie cmdlet ponawia próbę żądania. Jeśli to polecenie cmdlet nie otrzyma pomyślnej odpowiedzi przed upływem interwału, to polecenie cmdlet zwróci błąd.

Typ:Nullable<T>[Int32]
Aliasy:ClientTimeoutPerRequestInSeconds
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ConcurrentTaskCount

Określa maksymalne współbieżne wywołania sieciowe. Tego parametru można użyć, aby ograniczyć współbieżność w celu ograniczenia użycia lokalnego procesora CPU i przepustowości, określając maksymalną liczbę współbieżnych wywołań sieciowych. Określona wartość jest liczbą bezwzględną i nie jest mnożona przez liczbę rdzeni. Ten parametr może pomóc w zmniejszeniu problemów z połączeniem sieciowym w środowiskach o niskiej przepustowości, takich jak 100 kilobitów na sekundę. Wartość domyślna to 10.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Context

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst, użyj polecenia cmdlet New-AzStorageContext .

Typ:IStorageContext
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IncludeDeleted

Uwzględnij usunięte udziały, domyślnie udział get nie będzie zawierać usuniętych udziałów

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę udziału plików. To polecenie cmdlet pobiera udział plików określony przez ten parametr lub nic, jeśli określisz nazwę udziału plików, który nie istnieje.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Prefix

Określa prefiks udziałów plików. To polecenie cmdlet pobiera udziały plików, które są zgodne z prefiksem określonym przez ten parametr, lub bez udziałów plików, jeśli żadne udziały plików nie są zgodne z określonym prefiksem.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ServerTimeoutPerRequest

Określa długość limitu czasu dla części żądania serwera.

Typ:Nullable<T>[Int32]
Aliasy:ServerTimeoutPerRequestInSeconds
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SkipGetProperty

Określ ten parametr, aby wygenerować tylko obiekt udziału lokalnego bez pobierania właściwości udziału z serwera.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SnapshotTime

MigawkaTime migawki udziału plików, która ma zostać odebrana.

Typ:Nullable<T>[DateTimeOffset]
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

IStorageContext

Dane wyjściowe

AzureStorageFileShare