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.

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

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

-Context

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

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

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

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

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

-ServerTimeoutPerRequest

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

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

-SkipGetProperty

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

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

-SnapshotTime

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

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

Dane wejściowe

IStorageContext

Dane wyjściowe

AzureStorageFileShare