Get-AzStorageShare
Obtient une liste de partages de fichiers.
Syntaxe
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>] Description
L’applet de commande Get-AzStorageShare obtient une liste de partages de fichiers pour un compte de stockage.
Exemples
Exemple 1 : Obtenir un partage de fichiers
Get-AzStorageShare -Name "ContosoShare06"Cette commande obtient le partage de fichiers nommé ContosoShare06.
Exemple 2 : Obtenir tous les partages de fichiers commençant par une chaîne
Get-AzStorageShare -Prefix "Contoso"Cette commande obtient tous les partages de fichiers qui ont des noms qui commencent par Contoso.
Exemple 3 : Obtenir tous les partages de fichiers dans un contexte spécifié
$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $ContextLa première commande utilise l’applet de commande New-AzStorageContext pour créer un contexte à l’aide du paramètre local , puis stocke cet objet de contexte dans la variable $Context. La deuxième commande obtient les partages de fichiers pour l’objet de contexte stocké dans $Context.
Exemple 4 : Obtenir un instantané de partage de fichiers avec un nom de partage spécifique et SnapshotTime
Get-AzStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"Cette commande obtient un instantané de partage de fichiers avec un nom de partage spécifique et SnapshotTime.
Exemple 5 : Obtenir un objet de partage de fichiers sans récupérer les propriétés de partage avec l’authentification OAuth.
New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
$share = Get-AzStorageShare -Name "ContosoShare06" -SkipGetProperty -Context $ctxCette commande obtient un instantané de partage de fichiers sans obtenir les propriétés de partage avec l’authentification OAuth. L’obtention des propriétés de partage avec l’authentification OAuth échoue, car l’API ne prend pas en charge OAuth. Par conséquent, pour obtenir un objet de partage avec l’authentification OAuth, vous devez ignorer les propriétés de partage d’extraction.
Paramètres
-ClientTimeoutPerRequest
Spécifie l’intervalle de délai d’attente côté client, en secondes, pour une demande de service. Si l’appel précédent échoue dans l’intervalle spécifié, cette applet de commande retente la requête. Si cette applet de commande ne reçoit pas de réponse réussie avant l’expiration de l’intervalle, cette applet de commande retourne une erreur.
| Type: | Nullable<T>[Int32] |
| Alias: | ClientTimeoutPerRequestInSeconds |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ConcurrentTaskCount
Spécifie le nombre maximal d’appels réseau simultanés. Vous pouvez utiliser ce paramètre pour limiter l’accès concurrentiel pour limiter l’utilisation du processeur local et de la bande passante en spécifiant le nombre maximal d’appels réseau simultanés. La valeur spécifiée est un nombre absolu et n’est pas multipliée par le nombre de cœurs. Ce paramètre peut aider à réduire les problèmes de connexion réseau dans des environnements à faible bande passante, tels que 100 kilobits par seconde. La valeur par défaut est 10.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Context
Spécifie un contexte Stockage Azure. Pour obtenir un contexte, utilisez l’applet de commande New-AzStorageContext .
| Type: | IStorageContext |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-IncludeDeleted
Inclure des partages supprimés, par défaut, obtenir le partage n’inclut pas les partages supprimés
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom du partage de fichiers. Cette applet de commande obtient le partage de fichiers spécifié par ce paramètre, ou rien si vous spécifiez le nom d’un partage de fichiers qui n’existe pas.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Prefix
Spécifie le préfixe des partages de fichiers. Cette applet de commande obtient des partages de fichiers qui correspondent au préfixe spécifié par ce paramètre, ou aucun partage de fichiers si aucun partage de fichiers ne correspond au préfixe spécifié.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ServerTimeoutPerRequest
Spécifie la durée du délai d’attente pour la partie serveur d’une requête.
| Type: | Nullable<T>[Int32] |
| Alias: | ServerTimeoutPerRequestInSeconds |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SkipGetProperty
Spécifiez ce paramètre pour générer uniquement un objet de partage local, sans obtenir de propriétés de partage à partir du serveur.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SnapshotTime
SnapshotTime de l’instantané de partage de fichiers à recevoir.
| Type: | Nullable<T>[DateTimeOffset] |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |