다음을 통해 공유

New-AzDataFactoryEncryptValue

모듈:
Az.DataFactory Module

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

구문

ByFactoryName (기본값) 

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>]

ByFactoryObject 

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

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

  • 윈도우즈
  • 기초
  • 익명의.

매개 변수 속성

형식:String
Default value:None
허용되는 값:Windows, Basic, Anonymous
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:6
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Credential

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

매개 변수 속성

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

매개 변수 집합

(All)
Position:3
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Database

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

매개 변수 속성

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

매개 변수 집합

(All)
Position:8
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DataFactory

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

매개 변수 속성

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

매개 변수 집합

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

-DataFactoryName

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

매개 변수 속성

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

매개 변수 집합

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

-DefaultProfile

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

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-GatewayName

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

매개 변수 속성

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

매개 변수 집합

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

-NonCredentialValue

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

매개 변수 속성

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

매개 변수 집합

(All)
Position:5
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceGroupName

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

매개 변수 속성

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

매개 변수 집합

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

-Server

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

매개 변수 속성

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

매개 변수 집합

(All)
Position:7
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Type

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

  • OnPremisesSqlLinkedService
  • OnPremisesFileSystemLinkedService
  • OnPremisesOracleLinkedService
  • OnPremisesOdbcLinkedService
  • OnPremisesPostgreSqlLinkedService
  • OnPremisesTeradataLinkedService
  • OnPremisesMySQLLinkedService
  • OnPremisesDB2LinkedService
  • OnPremisesSybaseLinkedService

매개 변수 속성

형식:String
Default value:None
허용되는 값:OnPremisesSqlLinkedService, OnPremisesFileSystemLinkedService, OnPremisesOracleLinkedService, OnPremisesOdbcLinkedService, OnPremisesPostgreSqlLinkedService, OnPremisesTeradataLinkedService, OnPremisesMySQLLinkedService, OnPremisesDB2LinkedService, OnPremisesSybaseLinkedService, HdfsLinkedService
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:4
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Value

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

매개 변수 속성

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

매개 변수 집합

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

CommonParameters

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

입력

PSDataFactory

String

출력

String

참고

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