New-AzDataFactoryLinkedService
データ ストアまたはクラウド サービスを 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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DataFactory
PSDataFactory オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータ ファクトリのリンクされたサービスを作成します。
型: | PSDataFactory |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DataFactoryName
データ ファクトリの名前を指定します。 このコマンドレットは、このパラメーターが指定するデータ ファクトリのリンクされたサービスを作成します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-File
リンクされたサービスの説明を含む JavaScript Object Notation (JSON) ファイルの完全なパスを指定します。
型: | String |
配置: | 3 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
確認を求めずに、このコマンドレットが既存のリンクされたサービスを置き換えることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
作成するリンクされたサービスの名前を指定します。
型: | String |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
Azure リソース グループの名前を指定します。 このコマンドレットは、このパラメーターが指定するグループのリンクされたサービスを作成します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
メモ
- キーワード: azure, azurerm, arm, リソース, 管理, マネージャー, データ, ファクトリ
関連リンク
Azure PowerShell