Invoke-AzStorageSyncChangeDetection

リファレンス

モジュール:: Az.StorageSync

このコマンドを使用して、名前空間の変更の検出を手動で開始できます。共有、サブフォルダー、またはファイルのセット全体を対象にすることができます。 -DirectoryPath パラメーターまたは -Path パラメーターを指定してコマンドを実行すると、最大 10,000 個の項目を検出できます。変更のスコープがわかっている場合は、このコマンドの実行を名前空間の一部に制限して、変更の検出が迅速かつ 10,000 項目の制限内で完了できるようにします。または、これらのパラメーターを指定せずにコマンドレットを実行し、共有レベルの変更検出を呼び出すことで、項目の制限を回避することもできます。

Note

-DirectoryPath パラメーターまたは -Path パラメーターを指定して実行した場合、コマンドは Azure ファイル共有の次の変更を検出しません。

削除されたファイル。
共有から移動されたファイル。
削除され、同じ名前で作成されたファイル。

共有レベルの変更検出が呼び出されると、これらすべての変更が検出されます。これらの変更は、スケジュールされた change 検出ジョブ実行時にも検出されます。

構文

Invoke-AzStorageSyncChangeDetection
      [-ResourceGroupName] <String>
      [-StorageSyncServiceName] <String>
      [-SyncGroupName] <String>
      -Name <String>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceGroupName] <String>
      [-StorageSyncServiceName] <String>
      [-SyncGroupName] <String>
      -Name <String>
      -DirectoryPath <String>
      [-Recursive]
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceGroupName] <String>
      [-StorageSyncServiceName] <String>
      [-SyncGroupName] <String>
      -Name <String>
      -Path <String[]>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceId] <String>
      -DirectoryPath <String>
      [-Recursive]
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceId] <String>
      -Path <String[]>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-ResourceId] <String>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-InputObject] <PSCloudEndpoint>
      -DirectoryPath <String>
      [-Recursive]
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-InputObject] <PSCloudEndpoint>
      -Path <String[]>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-AzStorageSyncChangeDetection
      [-InputObject] <PSCloudEndpoint>
      [-PassThru]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Azure File Sync では、同期中の Azure ファイル共有内の名前空間で、同期以外の方法でファイル共有に加えた変更が定期的にチェックされます。目標は、これらの変更を特定し、最終的に接続されたサーバーに同期することです。このコマンドを使用すると、名前空間の変更の検出を手動で開始できます。共有、サブフォルダー、またはファイルのセット全体を対象にすることができます。変更の範囲がわかっている場合は、このコマンドの実行を名前空間の一部に制限して、個々の項目変更の検出が迅速かつ 10,000 個の項目の制限内で完了できるようにします。それ以外の場合は、-DirectoryPath パラメーターまたは -Path パラメーターを指定せずにコマンドを実行して、完全な共有レベルの変更検出を呼び出します。 Invoke-AzStorageSyncChangeDetection コマンドレットは、進行中のクラウド変更列挙ジョブを取り消します。現在実行中のジョブが取り消されないようにするには、ポータルのクラウドエンドポイントのプロパティに移動して、ジョブが現在実行されているかどうかを確認します。

例

例 1

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data","Reporting\Templates"

この例では、同期中の Azure ファイル共有の "Data" ディレクトリと "Reporting\Templates" ディレクトリで変更検出を実行します。すべてのパスは、Azure ファイル共有名前空間のルートに対する相対パスです。

例 2

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -Path "Data\results.xslx","Reporting\Templates\generated.pptx"

この例では、変更検出は、コマンド呼び出し元が変更したことがわかっている一連のファイルに対して実行されます。目標は、Azure ファイル同期でこれらの変更を検出して同期できるようにすることです。

例 3

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf" -DirectoryPath "Examples" -Recursive

この例では、"Examples" ディレクトリに対して変更検出が実行され、サブディレクトリ内の変更が再帰的に検出されます。パスに 10,000 個を超える項目が含まれている場合、コマンドレットは失敗します。パスに 10,000 を超える項目が含まれている場合は、名前空間のサブ部分でコマンドを実行します。

例 4

Invoke-AzStorageSyncChangeDetection -ResourceGroupName "myResourceGroup" -StorageSyncServiceName "myStorageSyncServiceName" -SyncGroupName "mySyncGroupName" -CloudEndpointName "b38fc242-8100-4807-89d0-399cef5863bf"

この例では、-DirectoryPath も -Path もコマンドに渡されていません。これにより、ファイル共有全体で変更検出が呼び出されます。

パラメーター

-AsJob

バックグラウンドでコマンドレットを実行する

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DirectoryPath

変更検出が実行されるディレクトリ。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

CloudEndpoint オブジェクト。通常はパラメーターを介して渡されます。

型:	PSCloudEndpoint
Aliases:	CloudEndpoint
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

CloudEndpoint の名前。名前は GUID であり、ポータルに表示されるフレンドリ名ではありません。 CloudEndpointName を取得するには、Get-AzStorageSyncCloudEndpoint コマンドレットを使用します。

型:	String
Aliases:	CloudEndpointName
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

通常の実行では、このコマンドレットは成功しても値を返しません。 PassThru パラメーターを指定すると、コマンドレットは正常に実行された後にパイプラインに値を書き込みます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Path

変更検出が実行されるパス。

型:	String[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Recursive

ディレクトリ変更の検出が再帰的かどうかを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

リソースグループ名。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceId

CloudEndpoint リソース ID

型:	String
Aliases:	CloudEndpointId
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-StorageSyncServiceName

StorageSyncService の名前。

型:	String
Aliases:	ParentName
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SyncGroupName

SyncGroup の名前。

型:	String
配置:	2
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

PSServerEndpoint

出力

Void

次の方法で共有