New-AzStorageFileSASToken
Gera um token de assinatura de acesso compartilhado para um arquivo de armazenamento.
Sintaxe
NameSasPermission
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
NameSasPolicy
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
-Policy <String>
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
FileSasPermission
New-AzStorageFileSASToken
-ShareFileClient <ShareFileClient>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
FileSasPolicy
New-AzStorageFileSASToken
-ShareFileClient <ShareFileClient>
-Policy <String>
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet New-AzStorageFileSASToken gera um token de assinatura de acesso partilhada para um ficheiro Armazenamento do Azure.
Exemplos
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"
Este comando gera um token de assinatura de acesso compartilhado que tem permissões totais para o arquivo chamado FilePath.
Exemplo 2: Gerar um token de assinatura de acesso compartilhado que tenha um limite de tempo
$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime
O primeiro comando cria um objeto DateTime usando o cmdlet Get-Date.
O comando armazena a hora atual na variável $StartTime.
O segundo comando adiciona duas horas ao objeto em $StartTime e, em seguida, armazena o resultado na variável $EndTime.
Este objeto é um tempo de duas horas no futuro.
O terceiro comando gera um token de assinatura de acesso compartilhado que tem as permissões especificadas.
Este token torna-se válido no momento atual.
O token permanece válido até o tempo armazenado em $EndTime.
Parâmetros
-Context
Especifica um contexto do Armazenamento do Azure.
Para obter um contexto, use o cmdlet New-AzStorageContext .
Propriedades dos parâmetros
Tipo: IStorageContext
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ExpiryTime
Especifica o momento em que a assinatura de acesso compartilhado se torna inválida.
Propriedades dos parâmetros
Tipo: Nullable<T> [ DateTime ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-FullUri
Indica que esse cmdlet retorna o URI de blob completo e o token de assinatura de acesso compartilhado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-IPAddressOrRange
Especifica o endereço IP ou o intervalo de endereços IP dos quais aceitar solicitações, como 168.1.5.65 ou 168.1.5.60-168.1.5.70.
A gama é inclusiva.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Path
Especifica o caminho do arquivo relativo a um compartilhamento de armazenamento.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NameSasPermission
Position: 1 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
NameSasPolicy
Position: 1 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Permission
Especifica as permissões para um arquivo de armazenamento.
É importante notar que esta é uma cadeia de caracteres, como rwd (para Ler, Escrever e Excluir).
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NameSasPermission
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
FileSasPermission
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Policy
Especifica a política de acesso armazenado para um arquivo.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NameSasPolicy
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
FileSasPolicy
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Protocol
Especifica o protocolo permitido para uma solicitação.
Os valores aceitáveis para este parâmetro são:
Disponível em: https...
HttpsOrHttp O valor padrão é HttpsOrHttp.
Propriedades dos parâmetros
Tipo: String
Default value: None Valores aceites: HttpsOnly, HttpsOrHttp Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ShareFileClient
Instância ShareFileClient para representar o arquivo contra o qual obter o token SAS.
Propriedades dos parâmetros
Tipo: ShareFileClient
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
FileSasPermission
Position: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
FileSasPolicy
Position: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ShareName
Especifica o nome do compartilhamento de armazenamento.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
NameSasPermission
Position: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
NameSasPolicy
Position: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-StartTime
Especifica o momento em que a assinatura de acesso compartilhado se torna válida.
Propriedades dos parâmetros
Tipo: Nullable<T> [ DateTime ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
