Get-AzStorageShare

  • Référence
Module:
Az.Storage

Obtient une liste de partages de fichiers.

Syntax

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-Az Stockage Share 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 $Context

La première commande utilise l’applet de commande New-Az Stockage Context 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 partage de fichiers instantané 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 partage de fichiers instantané 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 $ctx

Cette commande obtient un partage de fichiers instantané sans obtenir de 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]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Spécifie un contexte Stockage Azure. Pour obtenir un contexte, utilisez l’applet de commande New-Az Stockage Context.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

Inclure des partages supprimés, par défaut, obtenir le partage n’inclut pas les partages supprimés

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Spécifie la durée du délai d’attente pour la partie serveur d’une requête.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SnapshotTime

SnapshotTime du partage de fichiers instantané à recevoir.

Type:Nullable<T>[DateTimeOffset]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

IStorageContext

Sorties

AzureStorageFileShare