Invoke-AzStorageSyncChangeDetection
このコマンドを使用して、名前空間の変更の検出を手動で開始できます。 共有、サブフォルダー、またはファイルのセット全体を対象にすることができます。 -DirectoryPath パラメーターまたは -Path パラメーターを指定してコマンドを実行すると、最大 10,000 個の項目を検出できます。 変更のスコープがわかっている場合は、このコマンドの実行を名前空間の一部に制限して、変更の検出が迅速かつ 10,000 項目の制限内で完了できるようにします。 または、これらのパラメーターを指定せずにコマンドレットを実行し、共有レベルの変更検出を呼び出すことで、項目の制限を回避することもできます。
Note
-DirectoryPath パラメーターまたは -Path パラメーターを指定して実行した場合、コマンドは Azure ファイル共有の次の変更を検出しません。
- 削除されたファイル。
- 共有から移動されたファイル。
- 削除され、同じ名前で作成されたファイル。
共有レベルの変更検出が呼び出されると、これらすべての変更が検出されます。 これらの変更は、スケジュール された変更検出ジョブ の実行時にも検出されます。
構文
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
バックグラウンドでコマンドレットを実行する
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-DirectoryPath
変更検出が実行されるディレクトリ。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
CloudEndpoint オブジェクト。通常はパラメーターを介して渡されます。
| Type: | PSCloudEndpoint |
| Aliases: | CloudEndpoint |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
CloudEndpoint の名前。 名前は GUID であり、ポータルに表示されるフレンドリ名ではありません。 CloudEndpointName を取得するには、Get-AzStorageSyncCloudEndpoint コマンドレットを使用します。
| Type: | String |
| Aliases: | CloudEndpointName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
通常の実行では、このコマンドレットは成功しても値を返しません。 PassThru パラメーターを指定すると、コマンドレットは正常に実行された後にパイプラインに値を書き込みます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
変更検出が実行されるパス。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Recursive
ディレクトリ変更の検出が再帰的かどうかを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
リソース グループ名。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceId
CloudEndpoint リソース ID
| Type: | String |
| Aliases: | CloudEndpointId |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageSyncServiceName
StorageSyncService の名前。
| Type: | String |
| Aliases: | ParentName |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SyncGroupName
SyncGroup の名前。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
出力
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示