Partilhar via

New-AzStorageContext

  • Referência
Módulo:
Az.Storage

Cria um contexto de Armazenamento do Azure.

Sintaxe

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]
New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   -BlobEndpoint <String>
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   -SasToken <String>
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   -ConnectionString <String>
   [<CommonParameters>]
New-AzStorageContext
   [-Local]
   [<CommonParameters>]
New-AzStorageContext
   [-Anonymous]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]
New-AzStorageContext
   [-UseConnectedAccount]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

Description

O cmdlet New-AzStorageContext cria um contexto de Armazenamento do Azure. A Autenticação padrão de um Contexto de Armazenamento é OAuth (Microsoft Entra ID), se apenas inserir o nome da conta de Armazenamento. Consulte os detalhes da autenticação do Serviço de Armazenamento em https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Exemplos

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

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

Este 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

New-AzStorageContext -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

New-AzStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

Este 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

New-AzStorageContext -Local

Este 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

New-AzStorageContext -Local | Get-AzStorageContainer

Esse comando cria um contexto usando a conta de armazenamento de desenvolvimento local e, em seguida, passa o novo contexto para o cmdlet Get-AzStorageContainer do 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

$Context01 = New-AzStorageContext -Local 
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer

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

Exemplo 7: Criar um contexto com um ponto de extremidade

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

Este 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

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

Este 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

$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"

O primeiro comando gera um token SAS usando o cmdlet New-AzStorageContainerSASToken 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 no $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

Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Este comando cria um contexto usando a autenticação OAuth (Microsoft Entra ID).

Exemplo 11: Criar um contexto especificando um nome de conta de armazenamento, chave de conta de armazenamento e ponto de extremidade de blob personalizado

New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Este comando cria um contexto para a conta chamada myaccountname com uma chave para a conta e ponto de extremidade de blob especificado.

Exemplo 12: Criar um contexto para uma conta de armazenamento anônima com ponto de extremidade de blob especificado

New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Este comando cria um contexto para uso anônimo para a conta chamada myaccountname, com blob enpoint especificado.

Exemplo 13: Criar um contexto usando um token SAS com pontos de extremidade especificados

$SasToken = New-AzStorageContainerSASToken -Name "MyContainer" -Permission "rad"
New-AzStorageContext -SasToken $SasToken -BlobEndpoint "https://myaccountname.blob.core.windows.net/" -TableEndpoint "https://myaccountname.table.core.windows.net/" -FileEndpoint "https://myaccountname.file.core.windows.net/" -QueueEndpoint "https://myaccountname.queue.core.windows.net/"

O primeiro comando gera um token SAS usando o cmdlet New-AzStorageContainerSASToken para o contêiner chamado MyContainer e, em seguida, armazena esse token na variável $SasToken. O segundo comando cria um contexto que usa o token SAS e um ponto de extremidade de blob especificado, ponto de extremidade de tabela, ponto de extremidade de arquivo e ponto de extremidade de fila.

Exemplo 14: Criar um contexto usando a autenticação OAuth com um ponto de extremidade de blob especificado

New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

Este comando cria um contexto usando a autenticação OAuth com um ponto de extremidade de blob especificado.

Exemplo 15: Criar um contexto usando o serviço de autenticação OAuth no arquivo

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent

Este comando cria um contexto para usar a autenticação OAuth (Microsoft Entra ID) no serviço de arquivo. O parâmetro '-EnableFileBackupRequestIntent' é necessário para usar a autenticação OAuth (Microsoft Entra ID) para o serviço de arquivo. Isso ignorará qualquer verificação de permissão no nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo que haja ACLs em vigor para esses arquivos/diretórios.

Parâmetros

-Anonymous

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BlobEndpoint

Ponto de extremidade do serviço de blob de armazenamento do Azure

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ConnectionString

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnableFileBackupRequestIntent

Parâmetro necessário para usar com a autenticação OAuth (Microsoft Entra ID) para arquivos. Isso ignorará qualquer verificação de permissão no nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo que haja ACLs em vigor para esses arquivos/diretórios.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Endpoint

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Environment

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

Tipo:String
Aliases:Name, EnvironmentName
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-FileEndpoint

Ponto de extremidade do serviço de arquivo de armazenamento do Azure

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Local

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Protocol

Protocolo de transferência (https/http).

Tipo:String
Valores aceites:Http, Https
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-QueueEndpoint

Ponto de extremidade do serviço de fila de armazenamento do Azure

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SasToken

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StorageAccountKey

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

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StorageAccountName

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

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TableEndpoint

Ponto de extremidade do serviço de tabela de armazenamento do Azure

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UseConnectedAccount

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

AzureStorageContext