Udostępnij przez

Get-AzStorageShare

Moduł:
Az.Storage Module

Pobiera listę udziałów plików.

Składnia

MatchingPrefix (domyślnie) 

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

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.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:ClientTimeoutPerRequestInSeconds

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Context

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

Właściwości parametru

Typ:IStorageContext
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-IncludeDeleted

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

MatchingPrefix
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Specific
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

MatchingPrefix
Position:0
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ServerTimeoutPerRequest

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

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:ServerTimeoutPerRequestInSeconds

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SkipGetProperty

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Specific
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SnapshotTime

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

Właściwości parametru

Typ:

Nullable<T>[DateTimeOffset]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Specific
Position:1
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

IStorageContext

Dane wyjściowe

AzureStorageFileShare