Add-AzureEnvironment
Cria um ambiente do Azure.
Nota
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
Default (Predefinição)
Add-AzureEnvironment
-Name <String>
[-PublishSettingsFileUrl <String>]
[-ServiceEndpoint <String>]
[-ManagementPortalUrl <String>]
[-StorageEndpoint <String>]
[-ActiveDirectoryEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-GalleryEndpoint <String>]
[-ActiveDirectoryServiceEndpointResourceId <String>]
[-GraphEndpoint <String>]
[-AzureKeyVaultDnsSuffix <String>]
[-AzureKeyVaultServiceEndpointResourceId <String>]
[-TrafficManagerDnsSuffix <String>]
[-SqlDatabaseDnsSuffix <String>]
[-EnableAdfsAuthentication]
[-AdTenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
O cmdlet Add-AzureEnvironment cria um novo ambiente de conta personalizado do Azure e o salva em seu perfil de usuário móvel. O cmdlet retorna um objeto que representa o novo ambiente. Quando o comando for concluído, você poderá usar o ambiente no Windows PowerShell.
Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.
Somente o parâmetro Name deste cmdlet é obrigatório. Se você omitir um parâmetro, seu valor será nulo ($Null) e o serviço que usa esse ponto de extremidade pode não funcionar corretamente. Para adicionar ou alterar o valor de uma propriedade de ambiente, use o cmdlet Set-AzureEnvironment .
NOTA: Alterar o ambiente pode fazer com que a sua conta falhe. Normalmente, os ambientes são adicionados apenas para teste ou solução de problemas.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Exemplos
Exemplo 1: Adicionar um ambiente do Azure
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :
Este comando cria o ambiente do Azure ContosoEnv.
Parâmetros
-ActiveDirectoryEndpoint
Especifica o ponto de extremidade para a autenticação do Microsoft Entra no novo ambiente.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | AdEndpointUrl, ActiveDirectory, Active Directory Autoridade |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ActiveDirectoryServiceEndpointResourceId
Especifica a ID do recurso de uma API de gerenciamento cujo acesso é gerenciado pela ID do Microsoft Entra.
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: | True |
| Valor dos restantes argumentos: | False |
-AdTenant
O cmdlet Add-AzureEnvironment cria um novo ambiente de conta personalizado do Azure e o salva em seu perfil de usuário móvel. O cmdlet retorna um objeto que representa o novo ambiente. Quando o comando for concluído, você poderá usar o ambiente no Windows PowerShell.
Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.
Somente o parâmetro Name deste cmdlet é obrigatório. Se você omitir um parâmetro, seu valor será nulo ($Null) e o serviço que usa esse ponto de extremidade pode não funcionar corretamente. Para adicionar ou alterar o valor de uma propriedade de ambiente, use o cmdlet Set-AzureEnvironment .
NOTA: Alterar o ambiente pode fazer com que a sua conta falhe. Normalmente, os ambientes são adicionados apenas para teste ou solução de problemas.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
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: | True |
| Valor dos restantes argumentos: | False |
-AzureKeyVaultDnsSuffix
O cmdlet Add-AzureEnvironment cria um novo ambiente de conta personalizado do Azure e o salva em seu perfil de usuário móvel. O cmdlet retorna um objeto que representa o novo ambiente. Quando o comando for concluído, você poderá usar o ambiente no Windows PowerShell.
Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.
Somente o parâmetro Name deste cmdlet é obrigatório. Se você omitir um parâmetro, seu valor será nulo ($Null) e o serviço que usa esse ponto de extremidade pode não funcionar corretamente. Para adicionar ou alterar o valor de uma propriedade de ambiente, use o cmdlet Set-AzureEnvironment .
NOTA: Alterar o ambiente pode fazer com que a sua conta falhe. Normalmente, os ambientes são adicionados apenas para teste ou solução de problemas.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
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: | True |
| Valor dos restantes argumentos: | False |
-AzureKeyVaultServiceEndpointResourceId
O cmdlet Add-AzureEnvironment cria um novo ambiente de conta personalizado do Azure e o salva em seu perfil de usuário móvel. O cmdlet retorna um objeto que representa o novo ambiente. Quando o comando for concluído, você poderá usar o ambiente no Windows PowerShell.
Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.
Somente o parâmetro Name deste cmdlet é obrigatório. Se você omitir um parâmetro, seu valor será nulo ($Null) e o serviço que usa esse ponto de extremidade pode não funcionar corretamente. Para adicionar ou alterar o valor de uma propriedade de ambiente, use o cmdlet Set-AzureEnvironment .
NOTA: Alterar o ambiente pode fazer com que a sua conta falhe. Normalmente, os ambientes são adicionados apenas para teste ou solução de problemas.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
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: | True |
| Valor dos restantes argumentos: | False |
-EnableAdfsAuthentication
O cmdlet Add-AzureEnvironment cria um novo ambiente de conta personalizado do Azure e o salva em seu perfil de usuário móvel. O cmdlet retorna um objeto que representa o novo ambiente. Quando o comando for concluído, você poderá usar o ambiente no Windows PowerShell.
Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.
Somente o parâmetro Name deste cmdlet é obrigatório. Se você omitir um parâmetro, seu valor será nulo ($Null) e o serviço que usa esse ponto de extremidade pode não funcionar corretamente. Para adicionar ou alterar o valor de uma propriedade de ambiente, use o cmdlet Set-AzureEnvironment .
NOTA: Alterar o ambiente pode fazer com que a sua conta falhe. Normalmente, os ambientes são adicionados apenas para teste ou solução de problemas.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | OnPremise |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-GalleryEndpoint
Especifica o ponto de extremidade para a galeria do Azure Resource Manager, que armazena modelos de galeria de grupos de recursos. Para obter mais informações sobre grupos de recursos do Azure e modelos de galeria, consulte o tópico de ajuda para Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Galeria, GaleriaUrl |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-GraphEndpoint
O cmdlet Add-AzureEnvironment cria um novo ambiente de conta personalizado do Azure e o salva em seu perfil de usuário móvel. O cmdlet retorna um objeto que representa o novo ambiente. Quando o comando for concluído, você poderá usar o ambiente no Windows PowerShell.
Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.
Somente o parâmetro Name deste cmdlet é obrigatório. Se você omitir um parâmetro, seu valor será nulo ($Null) e o serviço que usa esse ponto de extremidade pode não funcionar corretamente. Para adicionar ou alterar o valor de uma propriedade de ambiente, use o cmdlet Set-AzureEnvironment .
NOTA: Alterar o ambiente pode fazer com que a sua conta falhe. Normalmente, os ambientes são adicionados apenas para teste ou solução de problemas.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Graph, GraphUrl |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ManagementPortalUrl
Especifica a URL do Portal de Gerenciamento do Azure no novo ambiente.
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: | True |
| Valor dos restantes argumentos: | False |
-Name
Especifica um nome para o ambiente. Este parâmetro é obrigatório. Não use os nomes dos ambientes padrão, AzureCloud e AzureChinaCloud.
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: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Propriedades dos parâmetros
| Tipo: | AzureSMProfile |
| 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 |
-PublishSettingsFileUrl
Especifica a URL dos arquivos de configurações de publicação para sua conta. Um arquivo de configurações de publicação do Azure é um arquivo XML que contém informações sobre sua conta e um certificado de gerenciamento que permite que o Windows PowerShell entre em sua conta do Azure em seu nome.
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: | True |
| Valor dos restantes argumentos: | False |
-ResourceManagerEndpoint
Especifica o ponto de extremidade para os dados do Azure Resource Manager, incluindo dados sobre grupos de recursos associados à conta.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Gestor de Recursos, GerenciadorDeRecursosUrl |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-ServiceEndpoint
Especifica a URL do ponto de extremidade do serviço do Azure. O ponto de extremidade do serviço do Azure determina se seu aplicativo é gerenciado pela plataforma global do Azure, o Azure operado pela 21Vianet na China ou uma instalação privada do Azure.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Gestão de Serviços, ServiceManagementUrl |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-SqlDatabaseDnsSuffix
O cmdlet Add-AzureEnvironment cria um novo ambiente de conta personalizado do Azure e o salva em seu perfil de usuário móvel. O cmdlet retorna um objeto que representa o novo ambiente. Quando o comando for concluído, você poderá usar o ambiente no Windows PowerShell.
Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.
Somente o parâmetro Name deste cmdlet é obrigatório. Se você omitir um parâmetro, seu valor será nulo ($Null) e o serviço que usa esse ponto de extremidade pode não funcionar corretamente. Para adicionar ou alterar o valor de uma propriedade de ambiente, use o cmdlet Set-AzureEnvironment .
NOTA: Alterar o ambiente pode fazer com que a sua conta falhe. Normalmente, os ambientes são adicionados apenas para teste ou solução de problemas.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
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: | True |
| Valor dos restantes argumentos: | False |
-StorageEndpoint
Especifica o ponto de extremidade padrão dos serviços de armazenamento no novo ambiente.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Sufixo do StorageEndpoint |
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 |
-TrafficManagerDnsSuffix
O cmdlet Add-AzureEnvironment cria um novo ambiente de conta personalizado do Azure e o salva em seu perfil de usuário móvel. O cmdlet retorna um objeto que representa o novo ambiente. Quando o comando for concluído, você poderá usar o ambiente no Windows PowerShell.
Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.
Somente o parâmetro Name deste cmdlet é obrigatório. Se você omitir um parâmetro, seu valor será nulo ($Null) e o serviço que usa esse ponto de extremidade pode não funcionar corretamente. Para adicionar ou alterar o valor de uma propriedade de ambiente, use o cmdlet Set-AzureEnvironment .
NOTA: Alterar o ambiente pode fazer com que a sua conta falhe. Normalmente, os ambientes são adicionados apenas para teste ou solução de problemas.
Este tópico descreve o cmdlet na versão 0.8.10 do módulo PowerShell do Microsoft Azure.
Para obter a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.
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: | True |
| 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.
Entradas
None
Você pode canalizar a entrada para esse cmdlet pelo nome da propriedade, mas não pelo valor.