Add-SqlAzureAuthenticationContext

참조

모듈:: SQLServer

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

SQLServer_Cmdlets

다음을 통해 공유

Add-SqlAzureAuthenticationContext

구문

Description

예제

예제 1: Azure Resource Manager에 사용자를 인증하기 위한 자격 증명을 사용자에게 표시

예제 2: Azure Resource Manager에 사용자 인증

예제 3: DefaultAzureCredential을 사용하여 Azure Resource Manager에 사용자 인증

예제 4: DefaultAzureCredential을 사용하지만 몇 가지 자격 증명 유형을 제외하여 Azure Resource Manager에 사용자를 인증합니다.

매개 변수

-ActiveDirectoryAuthority

-AzureKeyVaultResourceId

-AzureManagedHsmResourceId

-CertificateThumbprint

-ClientID

-DefaultAzureCredential

-ExcludeCredential

-Interactive

-ProgressAction

-Secret

-Tenant

출력

피드백

피드백

추가 리소스

다음을 통해 공유

Add-SqlAzureAuthenticationContext

구문

Description

예제

예제 1: Azure Resource Manager에 사용자를 인증하기 위한 자격 증명을 사용자에게 표시

예제 2: Azure Resource Manager에 사용자 인증

예제 3: DefaultAzureCredential을 사용하여 Azure Resource Manager에 사용자 인증

예제 4: DefaultAzureCredential을 사용하지만 몇 가지 자격 증명 유형을 제외하여 Azure Resource Manager에 사용자를 인증합니다.

매개 변수

-ActiveDirectoryAuthority

-AzureKeyVaultResourceId

-AzureManagedHsmResourceId

-CertificateThumbprint

-ClientID

-DefaultAzureCredential

-ExcludeCredential

-Interactive

-ProgressAction

-Secret

-Tenant

출력

관련 링크

피드백

피드백

추가 리소스