다음을 통해 공유

New-AzDataFactoryEncryptValue

  • 참조
모듈:
Az.DataFactory

중요한 데이터를 암호화합니다.

구문

New-AzDataFactoryEncryptValue
   [-DataFactoryName] <String>
   [[-Value] <SecureString>]
   [-GatewayName] <String>
   [[-Credential] <PSCredential>]
   [[-Type] <String>]
   [[-NonCredentialValue] <String>]
   [[-AuthenticationType] <String>]
   [[-Server] <String>]
   [[-Database] <String>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzDataFactoryEncryptValue
   [-DataFactory] <PSDataFactory>
   [[-Value] <SecureString>]
   [-GatewayName] <String>
   [[-Credential] <PSCredential>]
   [[-Type] <String>]
   [[-NonCredentialValue] <String>]
   [[-AuthenticationType] <String>]
   [[-Server] <String>]
   [[-Database] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

New-AzDataFactoryEncryptValue cmdlet은 암호 또는 Microsoft SQL Server 연결 문자열과 같은 중요한 데이터를 암호화하고 암호화된 값을 반환합니다.

예제

예제 1: 비 ODBC 연결 문자열 암호화

$Value = ConvertTo-SecureString 'Data Source=ContosoServer;Initial Catalog=catalog;user id =user123;password=******' -AsPlainText -Force 
New-AzDataFactoryEncryptValue -GatewayName "WikiGateway" -DataFactoryName "WikiAdf" -Value $value -ResourceGroupName "ADF" -Type OnPremisesSqlLinkedService

첫 번째 명령은 ConvertTo-SecureString cmdlet을 사용하여 지정된 연결 문자열을 SecureString 개체로 변환한 다음 해당 개체를 $Value 변수에 저장합니다. 자세한 내용은 Get-Help ConvertTo-SecureString입력합니다. 허용되는 값: SQL Server 또는 Oracle 연결 문자열입니다. 두 번째 명령은 지정된 데이터 팩터리, 게이트웨이, 리소스 그룹 및 연결된 서비스 유형에 대해 $Value 저장된 개체에 대해 암호화된 값을 만듭니다.

예제 2: Windows 인증을 사용하는 비 ODBC 연결 문자열을 암호화합니다.

$Value = ConvertTo-SecureString -String 'Data Source=ContosoServer;Initial Catalog=catalog;Integrated Security=True' -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesSqlLinkedService

첫 번째 명령은 ConvertTo-SecureString 사용하여 지정된 연결 문자열을 보안 문자열 개체로 변환한 다음 해당 개체를 $Value 변수에 저장합니다. 두 번째 명령은 Get-Credential cmdlet을 사용하여 windows 인증(사용자 이름 및 암호)을 수집한 다음 해당 PSCredential 개체를 $Credential 변수에 저장합니다. 자세한 내용은 Get-Help Get-Credential입력합니다. 세 번째 명령은 지정된 데이터 팩터리, 게이트웨이, 리소스 그룹 및 연결된 서비스 유형에 대한 $Value 및 $Credential 저장된 개체에 대해 암호화된 값을 만듭니다.

예제 3: 파일 시스템 연결된 서비스에 대한 서버 이름 및 자격 증명 암호화

$Value = ConvertTo-SecureString "******" -AsPlainText -Force
$Credential = Get-Credential
New-AzDataFactoryEncryptValue -DataFactoryName "WikiADF" -GatewayName "WikiGateway" -ResourceGroupName "ADF" -Value $Value -Credential $Credential -Type OnPremisesFileSystemLinkedService

첫 번째 명령은 ConvertTo-SecureString 사용하여 지정된 문자열을 보안 문자열로 변환한 다음 해당 개체를 $Value 변수에 저장합니다. 두 번째 명령은 Get-Credential 사용하여 Windows 인증(사용자 이름 및 암호)을 수집한 다음 해당 PSCredential 개체를 $Credential 변수에 저장합니다. 세 번째 명령은 지정된 데이터 팩터리, 게이트웨이, 리소스 그룹 및 연결된 서비스 유형에 대한 $Value 및 $Credential 저장된 개체에 대해 암호화된 값을 만듭니다.

예제 4: HDFS 연결된 서비스에 대한 자격 증명 암호화

$UserName = ConvertTo-SecureString "******" -AsPlainText -Force
$Password = ConvertTo-SecureString "******" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential ($UserName, $Password)
New-AzDataFactoryEncryptValue -DataFactoryName "MyDataFactory" -ResourceGroupName "MyResourceGroup" -GatewayName "MyDataManagementGateway" -Type HdfsLinkedService -AuthenticationType Windows -Credential $Credential -NonCredentialValue "http://server01.com:50070/webhdfs/v1/user/username"

ConvertTo-SecureString 명령은 지정된 문자열을 보안 문자열로 변환합니다. New-Object 명령은 보안 사용자 이름 및 암호 문자열을 사용하여 PSCredential 개체를 만듭니다. 대신 Get-Credential 명령을 사용하여 Windows 인증(사용자 이름 및 암호)을 수집한 다음, 반환된 PSCredential 개체를 이전 예제와 같이 $credential 변수에 저장할 수 있습니다. New-AzDataFactoryEncryptValue 명령은 지정된 데이터 팩터리, 게이트웨이, 리소스 그룹 및 연결된 서비스 유형에 대해 $Credential 저장된 개체에 대해 암호화된 값을 만듭니다.

예제 5: ODBC 연결된 서비스에 대한 자격 증명 암호화

$Content = ConvertTo-SecureString "UID=username@contoso;PWD=******;" -AsPlainText -Force
New-AzDataFactoryEncryptValue -ResourceGroupName $RGName -DataFactoryName $DFName -GatewayName $Gateway -Type OnPremisesOdbcLinkedService -AuthenticationType Basic -NonCredentialValue "Driver={SQL Server};Server=server01.database.contoso.net; Database=HDISScenarioTest;" -Value $content

ConvertTo-SecureString 명령은 지정된 문자열을 보안 문자열로 변환합니다. New-AzDataFactoryEncryptValue 명령은 지정된 데이터 팩터리, 게이트웨이, 리소스 그룹 및 연결된 서비스 유형에 대해 $Value 저장된 개체에 대해 암호화된 값을 만듭니다.

매개 변수

-AuthenticationType

데이터 원본에 연결하는 데 사용할 인증 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Windows
  • 기초의
  • 익명의.
형식:String
허용되는 값:Windows, Basic, Anonymous
Position:6
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Credential

사용할 Windows 인증 자격 증명(사용자 이름 및 암호)을 지정합니다. 이 cmdlet은 여기에 지정한 자격 증명 데이터를 암호화합니다.

형식:PSCredential
Position:3
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Database

연결된 서비스의 데이터베이스 이름을 지정합니다.

형식:String
Position:8
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DataFactory

PSDataFactory 개체를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 데이터 팩터리의 데이터를 암호화합니다.

형식:PSDataFactory
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DataFactoryName

데이터 팩터리의 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 데이터 팩터리의 데이터를 암호화합니다.

형식:String
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-GatewayName

게이트웨이의 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 게이트웨이에 대한 데이터를 암호화합니다.

형식:String
Position:2
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NonCredentialValue

ODBC(Open Database Connectivity) 연결 문자열의 자격 증명이 아닌 부분을 지정합니다. 이 매개 변수는 ODBC 연결된 서비스에만 적용됩니다.

형식:String
Position:5
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

Azure 리소스 그룹의 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 그룹의 데이터를 암호화합니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Server

연결된 서비스의 서버 이름을 지정합니다.

형식:String
Position:7
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Type

연결된 서비스 유형을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 연결된 서비스 유형에 대한 데이터를 암호화합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService
형식:String
허용되는 값:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
Position:4
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Value

암호화할 값을 지정합니다. 온-프레미스 SQL Server 연결된 서비스 및 온-프레미스 Oracle 연결된 서비스의 경우 연결 문자열을 사용합니다. 온-프레미스 ODBC 연결된 서비스의 경우 연결 문자열의 자격 증명 부분을 사용합니다. 온-프레미스 파일 시스템 연결된 서비스의 경우 파일 시스템이 게이트웨이 컴퓨터에 로컬인 경우 Local 또는 localhost를 사용하고, 파일 시스템이 게이트웨이 컴퓨터와 다른 서버에 있는 경우 \\servername을 사용합니다.

형식:SecureString
Position:1
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

출력

참고

  • 키워드: azure, azurerm, arm, 리소스, 관리, 관리자, 데이터, 팩터리