O cmdlet Add-SqlAzureAuthenticationContext autentica a conta principal especificada no Azure Resource Manager. Use esse cmdlet com outros cmdlets que interagem com recursos do Azure, como o Azure Key Vault.
Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.
Exemplos
Exemplo 1: solicitar credenciais a um usuário para autenticar um usuário no Azure Resource Manager
Add-SqlAzureAuthenticationContext -Interactive
Esse comando solicita a um usuário um nome de usuário e uma senha e autentica o usuário no Azure Resource Manager.
Exemplo 2: Autenticar um usuário no Azure Resource Manager
Esse comando executa a autenticação da entidade de segurança do aplicativo com a ID do cliente especificada, que foi definida no locatário especificado, para o Azure Resource Manager.
Exemplo 3: Usar DefaultAzureCredential para autenticar um usuário no Azure Resource Manager
Esse comando adquire token usando os seguintes tipos de credencial, se habilitados, serão testados, em ordem: WorkloadIdentityCredential, ManagedIdentityCredential, SharedTokenCacheCredential, VisualStudioCredential, VisualStudioCodeCredential, AzureCliCredential, AzurePowerShellCredential, InteractiveBrowserCredential.
OBSERVE que EnvironmentCredential, AzureDeveloperCliCredential são excluídos dos tipos acima.
Parâmetros
-ActiveDirectoryAuthority
Especifica a autoridade base para autenticação do Azure Active Directory.
Mesmo valor que a propriedade ActiveDirectoryAuthority do objeto ambiente do Azure PowerShell.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
DefaultAzureCredential Private
Cargo:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
Interactive Private
Cargo:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdSecret Private
Cargo:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdCertificate Private
Cargo:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-AzureKeyVaultResourceId
Especifica a ID do recurso para os serviços do Azure Key Vault. Mesmo valor que a propriedade AzureKeyVaultServiceEndpointResourceId do objeto Ambiente do Azure PowerShell.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
DefaultAzureCredential Private
Cargo:
2
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
Interactive Private
Cargo:
2
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdSecret Private
Cargo:
2
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdCertificate Private
Cargo:
2
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-AzureManagedHsmResourceId
Especifica a ID do recurso para o serviço HSM Gerenciado do Azure. Use esse parâmetro para substituir o valor https://managedhsm.azure.net padrão quando o recurso HSM gerenciado estiver em uma instância do Azure diferente da nuvem pública do Azure.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
DefaultAzureCredential Private
Cargo:
2
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
Interactive Private
Cargo:
2
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdSecret Private
Cargo:
2
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdCertificate Private
Cargo:
2
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-CertificateThumbprint
Especifica a impressão digital a ser usada para identificar o certificado a ser usado. O cmdlet pesquisará tanto quanto CurrentUser repositórios LocalMachine de certificados.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClientIdCertificate Public
Cargo:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdCertificate Private
Cargo:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-ClientID
Especifica a ID do cliente do aplicativo.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClientIdSecret Public
Cargo:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdSecret Private
Cargo:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdCertificate Public
Cargo:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdCertificate Private
Cargo:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-DefaultAzureCredential
Indica que esse cmdlet usa DefaultAzureCredential para adquirir token.
Os seguintes tipos de credencial, se habilitados, serão testados, na ordem:
Indica que esse cmdlet solicita credenciais ao usuário.
Propriedades do parâmetro
Tipo:
SwitchParameter
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
Interactive Public
Cargo:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
Interactive Private
Cargo:
0
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-Secret
Especifica o segredo do aplicativo.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClientIdSecret Public
Cargo:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdSecret Private
Cargo:
1
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-Tenant
Especifica um locatário no Azure.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
ClientIdSecret Public
Cargo:
2
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdSecret Private
Cargo:
2
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdCertificate Public
Cargo:
2
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
ClientIdCertificate Private
Cargo:
2
Obrigatório:
True
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.