Compartir a través de

Get-AzStorageShare

Módulo:
Az.Storage Module

Obtiene una lista de recursos compartidos de archivos.

Sintaxis

MatchingPrefix (valor predeterminado) 

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

El cmdlet Get-AzStorageShare obtiene una lista de recursos compartidos de archivos para una cuenta de almacenamiento.

Ejemplos

Ejemplo 1: Obtener un recurso compartido de archivos

Get-AzStorageShare -Name "ContosoShare06"

Este comando obtiene el recurso compartido de archivos denominado ContosoShare06.

Ejemplo 2: Obtener todos los recursos compartidos de archivos que comienzan con una cadena

Get-AzStorageShare -Prefix "Contoso"

Este comando obtiene todos los recursos compartidos de archivos que tienen nombres que comienzan por Contoso.

Ejemplo 3: Obtener todos los recursos compartidos de archivos en un contexto especificado

$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $Context

El primer comando usa el cmdlet New-AzStorageContext para crear un contexto mediante el parámetro Local y, a continuación, almacena ese objeto de contexto en la variable $Context. El segundo comando obtiene los recursos compartidos de archivos para el objeto de contexto almacenado en $Context.

Ejemplo 4: Obtención de una instantánea de recurso compartido de archivos con un nombre de recurso compartido específico y SnapshotTime

Get-AzStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

Este comando obtiene una instantánea de recurso compartido de archivos con un nombre de recurso compartido específico y SnapshotTime.

Ejemplo 5: Obtener un objeto de recurso compartido de archivos sin capturar propiedades de recurso compartido con la autenticación de OAuth.

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
$share = Get-AzStorageShare -Name "ContosoShare06" -SkipGetProperty -Context $ctx

Este comando obtiene una instantánea de recurso compartido de archivos sin obtener propiedades de recurso compartido con la autenticación de OAuth. Se producirá un error en la obtención de propiedades de recurso compartido con la autenticación de OAuth, ya que la API no admite OAuth. Por lo tanto, para obtener el objeto compartido con la autenticación de OAuth, debe omitir las propiedades de captura de recursos compartidos.

Parámetros

-ClientTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado cliente, en segundos, para una solicitud de servicio. Si se produce un error en la llamada anterior en el intervalo especificado, este cmdlet reintenta la solicitud. Si este cmdlet no recibe una respuesta correcta antes de que transcurre el intervalo, este cmdlet devuelve un error.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ConcurrentTaskCount

Especifica el número máximo de llamadas de red simultáneas. Puede usar este parámetro para limitar la simultaneidad para limitar el uso de ancho de banda y CPU local especificando el número máximo de llamadas de red simultáneas. El valor especificado es un recuento absoluto y no se multiplica por el recuento de núcleos. Este parámetro puede ayudar a reducir los problemas de conexión de red en entornos de ancho de banda bajo, como 100 kilobits por segundo. El valor predeterminado es 10.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Context

Especifica un contexto de Azure Storage. Para obtener un contexto, use el cmdlet New-AzStorageContext .

Propiedades de parámetro

Tipo:IStorageContext
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeDeleted

Incluir recursos compartidos eliminados, de forma predeterminada obtener recurso compartido no incluirá recursos compartidos eliminados.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

MatchingPrefix
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre del recurso compartido de archivos. Este cmdlet obtiene el recurso compartido de archivos que especifica este parámetro o nada si especifica el nombre de un recurso compartido de archivos que no existe.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Specific
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Prefix

Especifica el prefijo para los recursos compartidos de archivos. Este cmdlet obtiene recursos compartidos de archivos que coinciden con el prefijo que especifica este parámetro o ningún recurso compartido de archivos si ningún recurso compartido de archivos coincide con el prefijo especificado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

MatchingPrefix
Posición:0
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServerTimeoutPerRequest

Especifica el período de tiempo de espera para la parte del servidor de una solicitud.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SkipGetProperty

Especifique este parámetro para generar solo un objeto de recurso compartido local, sin obtener propiedades de recurso compartido del servidor.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Specific
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SnapshotTime

SnapshotTime de la instantánea del recurso compartido de archivos que se va a recibir.

Propiedades de parámetro

Tipo:

Nullable<T>[DateTimeOffset]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Specific
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

IStorageContext

Salidas

AzureStorageFileShare