New-AzStorageContext
Cria um contexto de Armazenamento do Azure.
Sintaxe
OAuthAccount (Padrão)
New-AzStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
AccountNameAndKey
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
AccountNameAndKeyEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-Environment <String>
[-Protocol <String>]
[<CommonParameters>]
AnonymousAccount
New-AzStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
AnonymousAccountEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-Environment <String>
[-Anonymous]
[-Protocol <String>]
[<CommonParameters>]
SasToken
New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
SasTokenWithAzureEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>]
OAuthAccountEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-Environment <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
AccountNameAndKeyServiceEndpoint
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-BlobEndpoint <String>
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
OAuthAccountServiceEndpoint
New-AzStorageContext
[[-StorageAccountName] <String>]
[-UseConnectedAccount]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
SasTokenServiceEndpoint
New-AzStorageContext
-SasToken <String>
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
ConnectionString
New-AzStorageContext
-ConnectionString <String>
[<CommonParameters>]
LocalDevelopment
New-AzStorageContext
[-Local]
[<CommonParameters>]
AnonymousAccountServiceEndpoint
New-AzStorageContext
[-Anonymous]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
Description
Exemplos
Exemplo 1: criar um contexto especificando um nome de conta de armazenamento e uma chave
New-AzStorageContext -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
New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"
Esse 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"
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
New-AzStorageContext -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
New-AzStorageContext -Local | Get-AzStorageContainer
Esse comando cria um contexto usando a conta de armazenamento de desenvolvimento local e passa o novo contexto para o cmdlet Get-AzStorageContainer 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 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 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"
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
New-AzStorageContext -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
$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 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 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
Esse comando cria um contexto usando a Autenticação OAuth (Microsoft Entra ID).
Exemplo 11: criar um contexto especificando um nome de conta de armazenamento, uma chave de conta de armazenamento e um ponto de extremidade de blob personalizado
New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
Esse comando cria um contexto para a conta chamada myaccountname com uma chave para a conta e o ponto de extremidade de blob especificado.
Exemplo 12: Criar um contexto para uma conta de armazenamento anônimo com o ponto de extremidade de blob especificado
New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
Esse comando cria um contexto para uso anônimo para a conta chamada myaccountname, com o ponto de extremidade de blob 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 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, ponto de extremidade de tabela, ponto de extremidade de arquivo e ponto de extremidade de fila especificados.
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/"
Esse comando cria um contexto usando a autenticação OAuth com um ponto de extremidade de blob especificado.
Exemplo 15: Criar um contexto usando a Autenticação OAuth no serviço arquivo
New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
Esse comando cria um contexto para usar a autenticação OAuth (Microsoft Entra ID) no serviço Arquivo.
O parâmetro '-EnableFileBackupRequestIntent' é necessário para usar a Autenticação OAuth (Microsoft Entra ID) para o serviço de arquivo. Isso ignorará as verificações de permissão de nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo se houver 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.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AnonymousAccount
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccountEnvironment
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccountServiceEndpoint
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-BlobEndpoint
Ponto de extremidade do serviço de blob de armazenamento do Azure
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AccountNameAndKeyServiceEndpoint
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ConnectionString
Especifica uma cadeia de conexão para o contexto do Armazenamento do Azure.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ConnectionString
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-EnableFileBackupRequestIntent
Parâmetro necessário para usar com a Autenticação OAuth (Microsoft Entra ID) para Arquivos. Isso ignorará as verificações de permissão de nível de arquivo/diretório e permitirá o acesso, com base nas ações de dados permitidas, mesmo se houver ACLs em vigor para esses arquivos/diretórios.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
OAuthAccount
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountEnvironment
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Endpoint
Especifica o ponto de extremidade para o contexto do Armazenamento do Azure.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
OAuthAccount
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameAndKey
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccount
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasToken
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: 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-AzEnvironment.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: Nome, EnvironmentName
Conjuntos de parâmetros
AccountNameAndKeyEnvironment
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
AnonymousAccountEnvironment
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-FileEndpoint
Ponto de extremidade do serviço de arquivo de armazenamento do Azure
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AccountNameAndKeyServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasTokenServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccountServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Local
Indica que esse cmdlet cria um contexto usando a conta de armazenamento de desenvolvimento local.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
LocalDevelopment
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Protocol
Protocolo de Transferência (https/http).
Propriedades do parâmetro
Tipo: String
Valor padrão: None Valores aceitos: Http, Https Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
OAuthAccount
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameAndKey
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameAndKeyEnvironment
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccount
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccountEnvironment
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasToken
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountEnvironment
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-QueueEndpoint
Ponto de extremidade de serviço da fila de armazenamento do Azure
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AccountNameAndKeyServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasTokenServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccountServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-SasToken
Especifica um token SAS (Assinatura de Acesso Compartilhado) para o contexto.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
SasToken
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasTokenWithAzureEnvironment
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasTokenServiceEndpoint
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-StorageAccountKey
Especifica uma chave de conta de Armazenamento do Azure.
Esse cmdlet cria um contexto para a chave especificada por esse parâmetro.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AccountNameAndKey
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameAndKeyEnvironment
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameAndKeyServiceEndpoint
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-StorageAccountName
Especifica um nome de conta de Armazenamento do Azure.
Esse cmdlet cria um contexto para a conta especificada por esse parâmetro.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
OAuthAccount
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameAndKey
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameAndKeyEnvironment
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccount
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccountEnvironment
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasToken
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasTokenWithAzureEnvironment
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountEnvironment
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameAndKeyServiceEndpoint
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-TableEndpoint
Ponto de extremidade de serviço da tabela de armazenamento do Azure
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AccountNameAndKeyServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
SasTokenServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AnonymousAccountServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-UseConnectedAccount
Indica que esse cmdlet cria um contexto de Armazenamento do Azure com a Autenticação OAuth (Microsoft Entra ID).
O cmdlet usará a Autenticação OAuth por padrão, quando outra autenticação não for especificada.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
OAuthAccount
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountEnvironment
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
OAuthAccountServiceEndpoint
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: 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
