Get-AzStorageFile

Modulo:

Az.Storage Module

Elenca directory e file per un percorso.

Sintassi

ShareName (Impostazione predefinita)

Get-AzStorageFile
    [-ShareName] <String>
    [[-Path] <String>]
    [-ExcludeExtendedInfo]
    [-DisAllowTrailingDot]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Share

Get-AzStorageFile
    [-ShareClient] <ShareClient>
    [[-Path] <String>]
    [-ExcludeExtendedInfo]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Directory

Get-AzStorageFile
    [-ShareDirectoryClient] <ShareDirectoryClient>
    [[-Path] <String>]
    [-ExcludeExtendedInfo]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Descrizione

Il cmdlet Get-AzStorageFile elenca directory e file per la condivisione o la directory specificata. Specificare il parametro Path per ottenere un'istanza di una directory o di un file nel percorso specificato. Questo cmdlet restituisce gli oggetti AzureStorageFile e AzureStorageDirectory . È possibile utilizzare la proprietà IsDirectory per distinguere tra cartelle e file.

Esempio

Esempio 1: Elencare le directory in una condivisione

Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}

Questo comando elenca solo le directory nella condivisione ContosoShare06. Recupera prima sia file che directory, li passa all'operatore where usando l'operatore pipeline, quindi rimuove tutti gli oggetti il cui tipo non è "AzureStorageFileDirectory".

Esempio 2: Elencare una directory file

Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile

Questo comando elenca i file e le cartelle nella directory ContosoWorkingFolder nella condivisione ContosoShare06. Ottiene prima l'istanza della directory e quindi la pipeline al cmdlet Get-AzStorageFile per elencare la directory.

Esempio 3: Elencare file e directory in una condivisione ed escludere informazioni estese

Get-AzStorageFile -ShareName "ContosoShare06" -ExcludeExtendedInfo

Questo comando elenca i file e le cartelle in nella condivisione ContosoShare06 ed esclude informazioni sui file estesi, ad esempio timestamp, ETag, attributi, permissionKey nel file di elenco e nella directory. Attualmente, -ExcludeExtendedInfo sarà necessario per elencare file e directory dalla condivisione file NFS o da una directory nella condivisione file NFS.

Parametri

-ClientTimeoutPerRequest

Specifica l'intervallo di timeout sul lato client, espresso in secondi, per una richiesta di servizio. Se la chiamata precedente ha esito negativo entro l'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.

Proprietà dei parametri

Tipo:	Nullable<T>[Int32]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	ClientTimeoutPerRequestInSeconds

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	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.

Proprietà dei parametri

Tipo:	Nullable<T>[Int32]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Context

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

Proprietà dei parametri

Tipo:	IStorageContext
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:	IAzureContextContainer
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	AzureRmContext, AzureCredential

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DisAllowTrailingDot

Non consentire il punto finale (.) per suffisso directory e nomi di file.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ShareName

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ExcludeExtendedInfo

Non includere informazioni sui file estesi, ad esempio timestamp, ETag, attributi, permissionKey nel file di elenco e nella directory.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Path

Specifica il percorso di una cartella. Se si omette il parametro Path , Get-AzStorageFile elenca le directory e i file nella condivisione file o nella directory specificata. Se si include il parametro Path , Get-AzStorageFile restituisce un'istanza di una directory o di un file nel percorso specificato.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	1
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ServerTimeoutPerRequest

Specifica l'intervallo di timeout sul lato servizio, espresso in secondi, per una richiesta. Se l'intervallo specificato è trascorso prima che il servizio elabori la richiesta, il servizio di archiviazione restituisce un errore.

Proprietà dei parametri

Tipo:	Nullable<T>[Int32]
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	ServerTimeoutPerRequestInSeconds

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ShareClient

L'oggetto ShareClient indica la condivisione in cui verranno elencati i file/directory.

Proprietà dei parametri

Tipo:	ShareClient
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Share

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-ShareDirectoryClient

L'oggetto ShareDirectoryClient indica la cartella di base in cui verranno elencati i file/directory.

Proprietà dei parametri

Tipo:	ShareDirectoryClient
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Directory

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-ShareName

Specifica il nome della condivisione file. Questo cmdlet ottiene un file o una directory dalla condivisione file specificata da questo parametro.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ShareName

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

ShareClient

ShareDirectoryClient

IStorageContext

Output

AzureStorageFile

Collegamenti correlati

• Get-AzStorageFileContent
• New-AzStorageDirectory
• Remove-AzStorageDirectory
• Remove-AzStorageFile
• Set-AzStorageFileContent