Partager via


Get-AzStorageShare

Obtient une liste de partages de fichiers.

Syntaxe

MatchingPrefix (Par défaut)

Get-AzStorageShare
    [[-Prefix] <String>]
    [-IncludeDeleted]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Specific

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 $Context

La 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 $ctx

Cette 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.

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Context

Spécifie un contexte de stockage Azure. Pour obtenir un contexte, utilisez l’applet de commande New-AzStorageContext .

Propriétés du paramètre

Type:IStorageContext
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IncludeDeleted

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

MatchingPrefix
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Specific
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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é.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

MatchingPrefix
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ServerTimeoutPerRequest

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

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Specific
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SnapshotTime

SnapshotTime de l’instantané de partage de fichiers à recevoir.

Propriétés du paramètre

Type:

Nullable<T>[DateTimeOffset]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Specific
Position:1
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

IStorageContext

Sorties

AzureStorageFileShare