Condividi tramite

Get-AzStorageShare

  • Riferimento
Modulo:
Az.Storage

Ottiene un elenco di condivisioni file.

Sintassi

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

Descrizione

Il cmdlet Get-AzStorageShare ottiene un elenco di condivisioni file per un account di archiviazione.

Esempio

Esempio 1: Ottenere una condivisione file

Get-AzStorageShare -Name "ContosoShare06"

Questo comando ottiene la condivisione file denominata ContosoShare06.

Esempio 2: Ottenere tutte le condivisioni file che iniziano con una stringa

Get-AzStorageShare -Prefix "Contoso"

Questo comando ottiene tutte le condivisioni file con nomi che iniziano con Contoso.

Esempio 3: Ottenere tutte le condivisioni file in un contesto specificato

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

Il primo comando usa il cmdlet New-AzStorageContext per creare un contesto usando il parametro Local e quindi archivia l'oggetto contesto nella variabile $Context. Il secondo comando ottiene le condivisioni file per l'oggetto contesto archiviato in $Context.

Esempio 4: Ottenere uno snapshot di condivisione file con nome di condivisione specifico e SnapshotTime

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

Questo comando ottiene uno snapshot di condivisione file con nome di condivisione specifico e SnapshotTime.

Esempio 5: Ottenere un oggetto condivisione file senza recuperare le proprietà di condivisione con l'autenticazione OAuth.

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

Questo comando ottiene uno snapshot di condivisione file senza ottenere le proprietà di condivisione con l'autenticazione OAuth. Ottenere le proprietà di condivisione con l'autenticazione OAuth avrà esito negativo perché l'API non supporta OAuth. Per ottenere l'oggetto di condivisione con l'autenticazione OAuth, è necessario ignorare le proprietà di condivisione di recupero.

Parametri

-ClientTimeoutPerRequest

Specifica l'intervallo di timeout lato client, espresso in secondi, per una richiesta di servizio. Se la chiamata precedente ha esito negativo nell'intervallo specificato, questo cmdlet ritenta la richiesta. Se questo cmdlet non riceve una risposta corretta prima della scadenza dell'intervallo, questo cmdlet restituisce un errore.

Tipo:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConcurrentTaskCount

Specifica il numero massimo di chiamate di rete simultanee. È possibile usare questo parametro per limitare la concorrenza per limitare l'utilizzo della CPU e della larghezza di banda locali specificando il numero massimo di chiamate di rete simultanee. Il valore specificato è un conteggio assoluto e non viene moltiplicato per il numero di core. Questo parametro consente di ridurre i problemi di connessione di rete in ambienti a larghezza di banda ridotta, ad esempio 100 kilobit al secondo. Il valore predefinito è 10.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Context

Specifica un contesto di Archiviazione di Azure. Per ottenere un contesto, usare il cmdlet New-AzStorageContext .

Tipo:IStorageContext
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeDeleted

Includi condivisioni eliminate, per impostazione predefinita get share non include condivisioni eliminate

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome della condivisione file. Questo cmdlet ottiene la condivisione file specificata da questo parametro o nulla se si specifica il nome di una condivisione file che non esiste.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Prefix

Specifica il prefisso per le condivisioni file. Questo cmdlet ottiene condivisioni file che corrispondono al prefisso specificato da questo parametro oppure nessuna condivisione file se nessuna condivisione file corrisponde al prefisso specificato.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServerTimeoutPerRequest

Specifica la durata del periodo di timeout per la parte server di una richiesta.

Tipo:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipGetProperty

Specificare questo parametro per generare solo un oggetto condivisione locale, senza ottenere proprietà di condivisione dal server.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SnapshotTime

SnapshotTime dello snapshot della condivisione file da ricevere.

Tipo:Nullable<T>[DateTimeOffset]
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

IStorageContext

Output

AzureStorageFileShare