Add-SqlAzureAuthenticationContext
Azure에 대한 인증을 수행하고 인증 토큰을 획득합니다.
구문
Add-SqlAzureAuthenticationContext
[-DefaultAzureCredential]
[[-ExcludeCredential] <CredentialType[]>]
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Add-SqlAzureAuthenticationContext
[-DefaultAzureCredential]
[[-ExcludeCredential] <CredentialType[]>]
[-ActiveDirectoryAuthority] <String>
[-AzureKeyVaultResourceId] <String>
[[-AzureManagedHsmResourceId] <String>]
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Add-SqlAzureAuthenticationContext
[-Interactive]
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Add-SqlAzureAuthenticationContext
[-Interactive]
[-ActiveDirectoryAuthority] <String>
[-AzureKeyVaultResourceId] <String>
[[-AzureManagedHsmResourceId] <String>]
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Add-SqlAzureAuthenticationContext
[-ClientID] <String>
[-Secret] <String>
[-Tenant] <String>
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Add-SqlAzureAuthenticationContext
[-ClientID] <String>
[-Secret] <String>
[-Tenant] <String>
[-ActiveDirectoryAuthority] <String>
[-AzureKeyVaultResourceId] <String>
[[-AzureManagedHsmResourceId] <String>]
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Add-SqlAzureAuthenticationContext
[-ClientID] <String>
[-CertificateThumbprint] <String>
[-Tenant] <String>
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Add-SqlAzureAuthenticationContext
[-ClientID] <String>
[-CertificateThumbprint] <String>
[-Tenant] <String>
[-ActiveDirectoryAuthority] <String>
[-AzureKeyVaultResourceId] <String>
[[-AzureManagedHsmResourceId] <String>]
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Description
Add-SqlAzureAuthenticationContext cmdlet은 지정된 주 계정을 Azure Resource Manager에 인증합니다. Azure Key Vault와 같은 Azure 리소스와 상호 작용하는 다른 cmdlet과 함께 이 cmdlet을 사용합니다.
Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.
예제
예제 1: Azure Resource Manager에 사용자를 인증하기 위한 자격 증명을 사용자에게 표시
Add-SqlAzureAuthenticationContext -Interactive이 명령은 사용자에게 사용자 이름 및 암호를 묻는 메시지를 표시한 다음, 사용자를 Azure Resource Manager에 인증합니다.
예제 2: Azure Resource Manager에 사용자 인증
Add-SqlAzureAuthenticationContext -ClientID 'ad34ca5a-a479-4cf4-b166-a2177b32d33e' -Secret '[Placeholder]' -Tenant '41fb6cc6-96f4-479d-bafd-a2e4810eb100'이 명령은 지정된 테넌트에 정의된 지정된 클라이언트 ID를 사용하여 Azure Resource Manager에 애플리케이션 주체의 인증을 수행합니다.
예제 3: DefaultAzureCredential을 사용하여 Azure Resource Manager에 사용자 인증
Add-SqlAzureAuthenticationContext -DefaultAzureCredential이 명령은 다음 자격 증명 형식을 사용하여 토큰을 획득합니다. 사용하도록 설정하면 EnvironmentCredential, WorkloadIdentityCredential, ManagedIdentityCredential, SharedTokenCacheCredential, VisualStudioCredential, VisualStudioCodeCredential, AzureCliCredential, AzurePowerShellCredential, AzureDeveloperCliCredential, InteractiveBrowserCredential 순서대로 시도됩니다.
예제 4: DefaultAzureCredential을 사용하지만 몇 가지 자격 증명 유형을 제외하여 Azure Resource Manager에 사용자를 인증합니다.
Add-SqlAzureAuthenticationContext -DefaultAzureCredential `
-ExcludeCredentials EnvironmentCredential, AzureDeveloperCliCredential이 명령은 사용하도록 설정된 경우 다음 자격 증명 형식을 사용하여 토큰을 획득합니다. WorkloadIdentityCredential, ManagedIdentityCredential, SharedTokenCacheCredential, VisualStudioCredential, VisualStudioCodeCredential, AzureCliCredential, AzurePowerShellCredential, InteractiveBrowserCredential 순서대로 시도됩니다. EnvironmentCredential, AzureDeveloperCliCredential은 위의 형식에서 제외됩니다.
매개 변수
-ActiveDirectoryAuthority
Azure Active Directory 인증에 대한 기본 기관을 지정합니다. Azure PowerShell Environment 개체의 ActiveDirectoryAuthority 속성과 동일한 값입니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AzureKeyVaultResourceId
Azure Key Vault 서비스의 리소스 ID를 지정합니다. Azure PowerShell Environment 개체의 AzureKeyVaultServiceEndpointResourceId 속성과 동일한 값입니다.
| 형식: | String |
| Position: | 2 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AzureManagedHsmResourceId
Azure Managed HSM 서비스의 리소스 ID를 지정합니다. 관리형 HSM 리소스가 Azure 퍼블릭 클라우드가 아닌 Azure 인스턴스에 있는 경우 이 매개 변수를 사용하여 https://managedhsm.azure.net 기본값을 재정의합니다.
| 형식: | String |
| Position: | 2 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CertificateThumbprint
사용할 인증서를 식별하는 데 사용할 지문을 지정합니다. cmdlet은 CurrentUser 인증서 저장소와 LocalMachine 인증서 저장소를 모두 검색합니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ClientID
애플리케이션 클라이언트 ID를 지정합니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultAzureCredential
이 cmdlet이 토큰을 획득하는 데 DefaultAzureCredential을 사용함을 나타냅니다. 사용하도록 설정된 경우 다음 자격 증명 형식이 순서대로 시도됩니다.
- EnvironmentCredential
- WorkloadIdentityCredential
- ManagedIdentityCredential
- SharedTokenCacheCredential
- VisualStudioCredential
- VisualStudioCodeCredential
- AzureCliCredential
- AzurePowerShellCredential
- AzureDeveloperCliCredential
- InteractiveBrowserCredential
각 자격 증명 형식에 대한 자세한 내용은 DefaultAzureCredential 클래스 참조하세요.
| 형식: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ExcludeCredential
DefaultAzureCredential이 토큰을 획득하는 동안 지정된 자격 증명 형식 목록을 제외해야 함을 나타냅니다.
| 형식: | CredentialType[] |
| 허용되는 값: | EnvironmentCredential, WorkloadIdentityCredential, ManagedIdentityCredential, SharedTokenCacheCredential, VisualStudioCredential, VisualStudioCodeCredential, AzureCliCredential, AzurePowerShellCredential, AzureDeveloperCliCredential, InteractiveBrowserCredential |
| Position: | 1 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Interactive
이 cmdlet은 사용자에게 자격 증명을 묻는 메시지를 표시합니다.
| 형식: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ProgressAction
powerShell이 스크립트, cmdlet 또는 공급자(예: Write-Progress cmdlet에서 생성된 진행률 표시줄)에 의해 생성된 진행률 업데이트에 응답하는 방법을 결정합니다. Write-Progress cmdlet은 명령의 상태를 표시하는 진행률 표시줄을 만듭니다.
| 형식: | ActionPreference |
| 별칭: | proga |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Secret
애플리케이션 비밀을 지정합니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Tenant
Azure에서 테넌트를 지정합니다.
| 형식: | String |
| Position: | 2 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
출력
System.Object