Add-SqlAzureAuthenticationContext

모듈:

SqlServer Module

Azure에 인증을 수행하고 인증 토큰을 획득합니다.

구문

DefaultAzureCredential Public

Add-SqlAzureAuthenticationContext
    [[-ExcludeCredential] <CredentialType[]>]
    [-DefaultAzureCredential]
    [<CommonParameters>]

DefaultAzureCredential Private

Add-SqlAzureAuthenticationContext
    [[-ExcludeCredential] <CredentialType[]>]
    [-ActiveDirectoryAuthority] <String>
    [-AzureKeyVaultResourceId] <String>
    [[-AzureManagedHsmResourceId] <String>]
    [-DefaultAzureCredential]
    [<CommonParameters>]

Interactive Public

Add-SqlAzureAuthenticationContext
    [-Interactive]
    [<CommonParameters>]

Interactive Private

Add-SqlAzureAuthenticationContext
    [-ActiveDirectoryAuthority] <String>
    [-AzureKeyVaultResourceId] <String>
    [[-AzureManagedHsmResourceId] <String>]
    [-Interactive]
    [<CommonParameters>]

ClientIdSecret Public

Add-SqlAzureAuthenticationContext
    [-ClientID] <String>
    [-Secret] <String>
    [-Tenant] <String>
    [<CommonParameters>]

ClientIdSecret Private

Add-SqlAzureAuthenticationContext
    [-ClientID] <String>
    [-Secret] <String>
    [-Tenant] <String>
    [-ActiveDirectoryAuthority] <String>
    [-AzureKeyVaultResourceId] <String>
    [[-AzureManagedHsmResourceId] <String>]
    [<CommonParameters>]

ClientIdCertificate Public

Add-SqlAzureAuthenticationContext
    [-ClientID] <String>
    [-CertificateThumbprint] <String>
    [-Tenant] <String>
    [<CommonParameters>]

ClientIdCertificate Private

Add-SqlAzureAuthenticationContext
    [-ClientID] <String>
    [-CertificateThumbprint] <String>
    [-Tenant] <String>
    [-ActiveDirectoryAuthority] <String>
    [-AzureKeyVaultResourceId] <String>
    [[-AzureManagedHsmResourceId] <String>]
    [<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 '00001111-aaaa-2222-bbbb-3333cccc4444' -Secret '[Placeholder]' -Tenant '11112222-bbbb-3333-cccc-4444dddd5555'

이 명령은 지정된 테넌트에 정의된 지정된 클라이언트 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
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

DefaultAzureCredential Private

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

Interactive Private

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdSecret Private

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdCertificate Private

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AzureKeyVaultResourceId

Azure Key Vault 서비스의 리소스 ID를 지정합니다. Azure PowerShell Environment 개체의 AzureKeyVaultServiceEndpointResourceId 속성과 동일한 값입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

DefaultAzureCredential Private

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

Interactive Private

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdSecret Private

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdCertificate Private

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AzureManagedHsmResourceId

Azure Managed HSM 서비스의 리소스 ID를 지정합니다. 관리형 HSM 리소스가 Azure 퍼블릭 클라우드가 아닌 Azure 인스턴스에 있는 경우 이 매개 변수를 사용하여 기본값 https://managedhsm.azure.net 을 재정의합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

DefaultAzureCredential Private

Position:	2
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

Interactive Private

Position:	2
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdSecret Private

Position:	2
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdCertificate Private

Position:	2
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CertificateThumbprint

사용할 인증서를 식별하는 데 사용할 지문을 지정합니다. cmdlet은 인증서 저장소와 CurrentUser 인증서 저장소를 모두 LocalMachine 검색합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ClientIdCertificate Public

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdCertificate Private

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ClientID

애플리케이션 클라이언트 ID를 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ClientIdSecret Public

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdSecret Private

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdCertificate Public

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdCertificate Private

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DefaultAzureCredential

이 cmdlet이 토큰을 획득하는 데 DefaultAzureCredential을 사용함을 나타냅니다. 사용하도록 설정된 경우 다음 자격 증명 형식이 순서대로 시도됩니다.

• EnvironmentCredential
• WorkloadIdentityCredential
• ManagedIdentityCredential
• SharedTokenCacheCredential
• VisualStudioCredential
• VisualStudioCodeCredential
• AzureCliCredential
• AzurePowerShellCredential
• AzureDeveloperCliCredential
• InteractiveBrowserCredential

각 자격 증명 형식에 대한 자세한 내용은 DefaultAzureCredential 클래스 를 참조하세요.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

DefaultAzureCredential Public

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

DefaultAzureCredential Private

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ExcludeCredential

DefaultAzureCredential이 토큰을 획득하는 동안 지정된 자격 증명 형식 목록을 제외해야 함을 나타냅니다.

매개 변수 속성

형식:	CredentialType[]
Default value:	None
허용되는 값:	EnvironmentCredential, WorkloadIdentityCredential, ManagedIdentityCredential, SharedTokenCacheCredential, VisualStudioCredential, VisualStudioCodeCredential, AzureCliCredential, AzurePowerShellCredential, AzureDeveloperCliCredential, InteractiveBrowserCredential
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

DefaultAzureCredential Public

Position:	1
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

DefaultAzureCredential Private

Position:	1
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Interactive

이 cmdlet은 사용자에게 자격 증명을 묻는 메시지를 표시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

Interactive Public

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

Interactive Private

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Secret

애플리케이션 비밀을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ClientIdSecret Public

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdSecret Private

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Tenant

Azure에서 테넌트를 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ClientIdSecret Public

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdSecret Private

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdCertificate Public

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

ClientIdCertificate Private

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

출력

System.Object

관련 링크

• SQLServer_Cmdlets