Invoke-AzStorageSyncChangeDetection

模組:

Az.StorageSync

此命令可用來手動起始命名空間變更的偵測。 它可以以整個共用、子資料夾或檔案集為目標。 使用 -DirectoryPath 或 -Path 參數執行命令時，最多可以偵測到 10,000 個專案。 如果您知道變更的範圍，請將此命令的執行限制為命名空間的一部分，因此變更偵測可以快速且在10,000個專案限制內完成。 或者，您可以藉由在沒有這些參數的情況下執行 Cmdlet 來避免專案限制，並叫用共用層級變更偵測。

注意

如果使用 -DirectoryPath 或 -Path 參數執行，命令將不會偵測 Azure 檔案共用中的下列變更：

• 已刪除的檔案。
• 已移出共用的檔案。
• 以相同名稱刪除和建立的檔案。

如果叫用共用層級變更偵測，將會偵測到所有這些變更。 當排程 的變更偵測作業 執行時，也會偵測到這些變更。

Syntax

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>]

Description

Azure 檔案同步 定期檢查同步處理 Azure 檔案共用內的命名空間，以取得同步處理以外的其他方式進入檔案共享的變更。目標是要識別這些變更，並最終將它們同步處理至已連線的伺服器。 此命令可用來手動起始命名空間變更的偵測。 它可以以整個共用、子資料夾或檔案集為目標。 如果您知道變更的範圍，請將此命令的執行限制為命名空間的一部分，因此個別專案變更偵測可以快速且在10,000個專案限制內完成。 否則，請執行不含 -DirectoryPath 或 -Path 參數的命令，以叫用完整的共用層級變更偵測。 Invoke-Az 儲存體 SyncChangeDetection Cmdlet 將會取消進行中的雲端變更列舉作業。 若要避免取消目前正在執行的作業，請移至入口網站中的雲端端點屬性，以檢查作業目前是否正在執行。

範例

範例 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

在此範例中，會針對 「範例」目錄執行變更偵測，並遞歸地偵測子目錄中的變更。 請記住，如果路徑包含超過10,000個專案，Cmdlet 將會失敗。 如果路徑包含超過 10,000 個專案，請在命名空間的子元件上執行 命令。

範例 4

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

在此範例中，-DirectoryPath 和 -Path 都未傳遞至 命令。 這會在整個檔案共用上叫用變更偵測。

參數

-AsJob

在背景執行 Cmdlet

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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-Az 儲存體 SyncCloudEndpoint Cmdlet。

Type:	String
Aliases:	CloudEndpointName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

在一般執行中，此 Cmdlet 不會傳回成功值。 如果您提供PassThru參數，則 Cmdlet 會在成功執行之後，將值寫入管線。

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 資源標識符

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

-StorageSyncServiceName

儲存體 SyncService 的名稱。

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

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

String

PSServerEndpoint

輸出

Void