Compartilhar via

New-AzureStorageContext

  • Referência
Módulo:
Azure.Storage

Cria um contexto do Armazenamento do Azure.

Aviso

O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

New-AzureStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzureStorageContext
   -ConnectionString <String>
   [<CommonParameters>]
New-AzureStorageContext
   [-Local]
   [<CommonParameters>]

Description

O cmdlet New-AzureStorageContext cria um contexto de Armazenamento do Azure.

Exemplos

Exemplo 1: Criar um contexto especificando um nome e uma chave de conta de armazenamento

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

Esse comando cria um contexto para a conta chamada ContosoGeneral que usa a chave especificada.

Exemplo 2: Criar um contexto especificando uma cadeia de conexão

C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

Este comando cria um contexto com base na cadeia de conexão especificada para a conta ContosoGeneral.

Exemplo 3: Criar um contexto para uma conta de armazenamento anônima

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

Esse comando cria um contexto para uso anônimo para a conta chamada ContosoGeneral. O comando especifica HTTP como um protocolo de conexão.

Exemplo 4: Criar um contexto usando a conta de armazenamento de desenvolvimento local

C:\PS>New-AzureStorageContext -Local

Esse comando cria um contexto usando a conta de armazenamento de desenvolvimento local. O comando especifica o parâmetro Local .

Exemplo 5: Obter o contêiner para a conta de armazenamento do desenvolvedor local

C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainer

Esse comando cria um contexto usando a conta de armazenamento de desenvolvimento local e passa o novo contexto para o cmdlet Get-AzureStorageContainer usando o operador de pipeline. O comando obtém o contêiner de Armazenamento do Azure para a conta de armazenamento do desenvolvedor local.

Exemplo 6: Obter vários contêineres

C:\PS>$Context01 = New-AzureStorageContext -Local 
PS C:\> $Context02 = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($Context01, $Context02) | Get-AzureStorageContainer

O primeiro comando cria um contexto usando a conta de armazenamento de desenvolvimento local e, em seguida, armazena esse contexto na variável $Context 01. O segundo comando cria um contexto para a conta chamada ContosoGeneral que usa a chave especificada e, em seguida, armazena esse contexto na variável $Context 02. O comando final obtém os contêineres para os contextos armazenados em $Context 01 e $Context 02 usando Get-AzureStorageContainer.

Exemplo 7: Criar um contexto com um ponto de extremidade

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

Esse comando cria um contexto de Armazenamento do Azure que tem o ponto de extremidade de armazenamento especificado. O comando cria o contexto para a conta chamada ContosoGeneral que usa a chave especificada.

Exemplo 8: Criar um contexto com um ambiente especificado

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

Esse comando cria um contexto de armazenamento do Azure que tem o ambiente do Azure especificado. O comando cria o contexto para a conta chamada ContosoGeneral que usa a chave especificada.

Exemplo 9: Criar um contexto usando um token SAS

C:\PS>$SasToken = New-AzureStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $Context | Get-AzureStorageBlob -Container "ContosoMain"

O primeiro comando gera um token SAS usando o cmdlet New-AzureStorageContainerSASToken para o contêiner chamado ContosoMain e, em seguida, armazena esse token na variável $SasToken. Esse token é para permissões de leitura, adição, atualização e exclusão. O segundo comando cria um contexto para a conta chamada ContosoGeneral que usa o token SAS armazenado em $SasToken e, em seguida, armazena esse contexto na variável $Context. O comando final lista todos os blobs associados ao contêiner chamado ContosoMain usando o contexto armazenado em $Context.

Exemplo 10: Criar um contexto usando a autenticação OAuth

C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Esse comando cria um contexto usando a autenticação OAuth.

Parâmetros

-Anonymous

Indica que esse cmdlet cria um contexto de Armazenamento do Azure para logon anônimo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConnectionString

Especifica uma cadeia de conexão para o contexto de Armazenamento do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Endpoint

Especifica o ponto de extremidade para o contexto de Armazenamento do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Environment

Especifica o ambiente do Azure. Os valores aceitáveis para esse parâmetro são: AzureCloud e AzureChinaCloud. Para obter mais informações, digite Get-Help Get-AzureEnvironment.

Tipo:String
Aliases:Name, EnvironmentName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Local

Indica que esse cmdlet cria um contexto usando a conta de armazenamento de desenvolvimento local.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Protocol

Protocolo de Transferência (https/http).

Tipo:String
Valores aceitos:Http, Https
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SasToken

Especifica um token SAS (Assinatura de Acesso Compartilhado) para o contexto.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageAccountKey

Especifica uma chave de conta de Armazenamento do Azure. Esse cmdlet cria um contexto para a chave especificada por esse parâmetro.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageAccountName

Especifica um nome de conta de Armazenamento do Azure. Esse cmdlet cria um contexto para a conta especificada por esse parâmetro.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseConnectedAccount

Indica que esse cmdlet cria um contexto de Armazenamento do Azure com a Autenticação OAuth. O cmdlet usará a Autenticação OAuth por padrão, quando outra autenticação não for especificada.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Saídas

AzureStorageContext