New-AzStorageFileSymbolicLink
指定したファイルへのシンボリック リンクを作成します。 NFS ファイル共有でのみ機能します。
構文
ShareName (既定)
New-AzStorageFileSymbolicLink
[-ShareName] <String>
[-Path] <String>
[-LinkText] <String>
[-Metadata <Hashtable>]
[-FileCreatedOn <DateTimeOffset>]
[-FileLastWrittenOn <DateTimeOffset>]
[-Owner <String>]
[-Group <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Share
New-AzStorageFileSymbolicLink
[-ShareClient] <ShareClient>
[-Path] <String>
[-LinkText] <String>
[-Metadata <Hashtable>]
[-FileCreatedOn <DateTimeOffset>]
[-FileLastWrittenOn <DateTimeOffset>]
[-Owner <String>]
[-Group <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Directory
New-AzStorageFileSymbolicLink
[-ShareDirectoryClient] <ShareDirectoryClient>
[-Path] <String>
[-LinkText] <String>
[-Metadata <Hashtable>]
[-FileCreatedOn <DateTimeOffset>]
[-FileLastWrittenOn <DateTimeOffset>]
[-Owner <String>]
[-Group <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-AzStorageFileSymbolicLink コマンドレットは、Azure ファイル共有内のファイルへのシンボリック リンクを作成します。 このコマンドレットは NFS ファイル共有でのみ機能します。 シンボリック リンクは、別のファイルまたはディレクトリを指すファイルです。 シンボリック リンクは、相対パスまたは絶対パスを使用して、同じファイル共有内のファイル、またはファイル共有の外部にあるファイルを指すことができます。
例
例 1: 省略可能なすべてのパラメーターを含むシンボリック リンクを作成する
$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
New-AzStorageFileSymbolicLink -ShareName "nfsshare" -Path "links/testlink" -LinkText "config/app.conf" -Metadata @{ "meta1"="value1";"meta2"="value2"} -FileCreatedOn "2025-09-01T00:00:00Z" -FileLastWrittenOn "2025-09-15T12:00:00Z" -Owner "1000" -Group "1000" -Context $ctx
このコマンドは、使用可能なすべての省略可能なパラメーターを持つシンボリック リンクを作成します。シンボリック リンクは相対パス "config/app.conf" を指します。
例 2: ShareClient オブジェクトを使用してシンボリック リンクを作成する
$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
$shareClient = Get-AzStorageShare -Name "nfsshare" -Context $ctx
$shareClient | New-AzStorageFileSymbolicLink -Path "dir1/app-link" -LinkText "config/app.conf"
このコマンドは、Get-AzStorageShare から取得した ShareClient オブジェクトを使用してシンボリック リンクを作成します。
例 3: ディレクトリ クライアントを使用してシンボリック リンクを作成する
$ctx = New-AzStorageContext -StorageAccountName "myaccount" -EnableFileBackupRequestIntent
$dirClient = Get-AzStorageFile -ShareName "nfsshare" -Path "testdir" -Context $ctx
$dirClient | New-AzStorageFileSymbolicLink -Path "testlink" -LinkText "app/main.exe"
このコマンドは、ShareDirectoryClient オブジェクトを使用して、特定のディレクトリ内にシンボリック リンクを作成します。
パラメーター
-ClientTimeoutPerRequest
各要求のクライアント側の最大実行時間 (秒単位)。
パラメーターのプロパティ
| 型: | Nullable<T>[Int32]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ClientTimeoutPerRequestInSeconds |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ConcurrentTaskCount
同時実行非同期タスクの合計量。
既定値は 10 です。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Context
Azure Storage Context オブジェクト
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FileCreatedOn
シンボリック リンクの作成時刻。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FileLastWrittenOn
シンボリック リンクの最後の書き込み時刻。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Group
Optional.
シンボリック リンクに設定する所有者グループ識別子 (GID)。
既定値は 0 (ルート グループ) です。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LinkText
リンク先のファイルの絶対パスまたは相対パス。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
シンボリック リンク用に設定するオプションのカスタム メタデータ。
| 型: | Hashtable
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Owner
Optional.
シンボリック リンクに設定する所有者ユーザー識別子 (UID)。
既定値は 0 (ルート) です。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
作成するシンボリック リンクのパス。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ServerTimeoutPerRequest
各要求のサーバー タイムアウト (秒単位)。
パラメーターのプロパティ
| 型: | Nullable<T>[Int32]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ServerTimeoutPerRequestInSeconds |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ShareClient
ShareClient オブジェクトは、シンボリック リンクが作成される共有を示しました。
パラメーターのプロパティ
| 型: | ShareClient
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Share
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ShareDirectoryClient
ShareDirectoryClient オブジェクトは、シンボリック リンクが作成されるベース フォルダーを示しました。
パラメーターのプロパティ
パラメーター セット
Directory
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ShareName
シンボリック リンクが作成されるファイル共有の名前。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ShareName
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
メモ
- このコマンドレットは NFS ファイル共有でのみ機能します
- シンボリック リンクは、同じ共有または外部の場所内のファイルを指すことができます
- シンボリック リンクはディレクトリ一覧に通常のファイルとして表示されますが、ターゲット パスへの参照が含まれています