New-AzureStorageContext
Cria um contexto de armazenamento do Azure.
Aviso
O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação 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 == >"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
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"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
C:\PS>New-AzureStorageContext -LocalEste 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-AzureStorageContainerEste comando cria um contexto usando a conta de armazenamento de desenvolvimento local e, em seguida, 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-AzureStorageContainerO 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"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
C:\PS>New-AzureStorageContext -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
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 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
C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccountEste 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 |
| 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 |
-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-AzureEnvironment.
| Tipo: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| 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 |
-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 |
-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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |