New-AzDataFactoryLinkedService

  • リファレンス
モジュール:
Az.DataFactory

データ ストアまたはクラウド サービスを Azure Data Factory にリンクします。

構文

New-AzDataFactoryLinkedService
   [-DataFactoryName] <String>
   [[-Name] <String>]
   [-File] <String>
   [-Force]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDataFactoryLinkedService
   [-DataFactory] <PSDataFactory>
   [[-Name] <String>]
   [-File] <String>
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzDataFactoryLinkedService コマンドレットは、データ ストアまたはクラウド サービスを Azure Data Factory にリンクします。 既に存在するリンクされたサービスの名前を指定した場合、このコマンドレットは、リンクされたサービスを置き換える前に確認を求められます。 Force パラメーターを指定した場合、コマンドレットは確認なしで既存のリンクされたサービスを置き換えます。 次の順序でこれらの操作を実行します。

  • データ ファクトリを作成します。
  • リンクされたサービスを作成します。
  • データセットを作成します。
  • パイプラインを作成します。

例

例 1: リンクされたサービスを作成する

New-AzDataFactoryLinkedService -ResourceGroupName "ADF" -DataFactoryName "WikiADF" -Name "LinkedServiceCuratedWikiData" -File "C:\\samples\\WikiSample\\LinkedServiceCuratedWikiData.json" | Format-List

LinkedServiceName : LinkedServiceCuratedWikiData
ResourceGroupName : ADF
DataFactoryName   : WikiADF
Properties        : Microsoft.DataFactories.AzureStorageLinkedService

このコマンドは、WikiADF という名前のデータ ファクトリに LinkedServiceCuratedWikiData という名前のリンクされたサービスを作成します。 このリンクされたサービスは、ファイルで指定された Azure BLOB ストアを WikiADF という名前のデータ ファクトリにリンクします。 このコマンドは、パイプライン演算子を使用して Format-List コマンドレットに結果を渡します。 その Windows PowerShell コマンドレットによって結果が書式設定されます。 詳細を表示するには「Get-Help Format-List」を入力します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DataFactory

PSDataFactory オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータ ファクトリのリンクされたサービスを作成します。

Type:PSDataFactory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DataFactoryName

データ ファクトリの名前を指定します。 このコマンドレットは、このパラメーターが指定するデータ ファクトリのリンクされたサービスを作成します。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

リンクされたサービスの説明を含む JavaScript Object Notation (JSON) ファイルの完全なパスを指定します。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

確認を求めずに、このコマンドレットが既存のリンクされたサービスを置き換えることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

作成するリンクされたサービスの名前を指定します。

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Azure リソース グループの名前を指定します。 このコマンドレットは、このパラメーターが指定するグループのリンクされたサービスを作成します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

PSDataFactory

String

出力

PSLinkedService

メモ

  • キーワード: azure, azurerm, arm, リソース, 管理, マネージャー, データ, ファクトリ