Get-AzStorageContainer
Elenca i contenitori di archiviazione.
Sintassi
Get-AzStorageContainer
[[-Name] <String>]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Get-AzStorageContainer
-Prefix <String>
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Descrizione
Il cmdlet Get-AzStorageContainer elenca i contenitori di archiviazione associati all'account di archiviazione in Azure.
Esempio
Esempio 1: Ottenere il contenitore di Archiviazione di Azure in base al nome
Get-AzStorageContainer -Name container*
In questo esempio viene usato un carattere jolly per restituire un elenco di tutti i contenitori con un nome che inizia con il contenitore.
Esempio 2: Ottenere il contenitore di Archiviazione di Azure in base al prefisso del nome del contenitore
Get-AzStorageContainer -Prefix "container"
In questo esempio viene usato il parametro prefisso
Esempio 3: Elencare il contenitore di Archiviazione di Azure, includere contenitori eliminati
$containers = Get-AzStorageContainer -IncludeDeleted -Context $ctx
$containers
Storage Account Name: storageaccountname
Name PublicAccess LastModified IsDeleted VersionId
---- ------------ ------------ --------- ---------
testcon Off 8/28/2020 10:18:13 AM +00:00
testcon2 9/4/2020 12:52:37 PM +00:00 True 01D67D248986B6DA
$c[1].BlobContainerProperties
LastModified : 9/4/2020 12:52:37 PM +00:00
LeaseStatus : Unlocked
LeaseState : Expired
LeaseDuration :
PublicAccess :
HasImmutabilityPolicy : False
HasLegalHold : False
DefaultEncryptionScope : $account-encryption-key
PreventEncryptionScopeOverride : False
DeletedOn : 9/8/2020 4:29:59 AM +00:00
RemainingRetentionDays : 299
ETag : "0x8D850D167059285"
Metadata : {}
Questo esempio elenca tutti i contenitori di un account di archiviazione, inclusi i contenitori eliminati. Visualizzare quindi le proprietà del contenitore eliminate, includere : DeletedOn, RemainingRetentionDays. I contenitori eliminati saranno presenti solo dopo l'abilitazione dell'eliminazione temporanea del contenitore con Enable-AzStorageBlobDeleteRetentionPolicy.
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 il contesto di archiviazione. Per crearlo, è possibile usare il cmdlet New-AzStorageContext. Le autorizzazioni del contenitore non verranno recuperate quando si usa un contesto di archiviazione creato dal token di firma di accesso condiviso, perché le autorizzazioni del contenitore di query richiedono l'autorizzazione chiave dell'account di archiviazione.
Tipo: | IStorageContext |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ContinuationToken
Specifica un token di continuazione per l'elenco di BLOB.
Tipo: | BlobContinuationToken |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione 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 contenitori eliminati, per impostazione predefinita i contenitori di elenco non includono contenitori eliminati
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-MaxCount
Specifica il numero massimo di oggetti restituiti dal cmdlet.
Tipo: | Nullable<T>[Int32] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Name
Specifica il nome del contenitore. Se il nome del contenitore è vuoto, il cmdlet elenca tutti i contenitori. In caso contrario, elenca tutti i contenitori che corrispondono al nome specificato o al modello di nome normale.
Tipo: | String |
Alias: | N, Container |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | True |
-Prefix
Specifica un prefisso usato nel nome del contenitore o dei contenitori da ottenere. È possibile usarlo per trovare tutti i contenitori che iniziano con la stessa stringa, ad esempio "my" o "test".
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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.
Tipo: | Nullable<T>[Int32] |
Alias: | ServerTimeoutPerRequestInSeconds |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |