Invoke-AzStorageSyncChangeDetection

參考

模組:: Az.StorageSync

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

注意

如果使用 -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>]

Description

Azure 檔案同步會定期檢查同步處理 Azure 檔案共用內的命名空間，以取得同步處理以外的其他方式進入檔案共享的變更。目標是要識別這些變更，並最終將它們同步處理至已連線的伺服器。此命令可用來手動起始命名空間變更的偵測。它可以以整個共用、子資料夾或檔案集為目標。如果您知道變更的範圍，請將此命令的執行限制為命名空間的一部分，因此個別專案變更偵測可以快速且在10,000個專案限制內完成。否則，請執行命令，而不使用 -DirectoryPath 或 -Path 參數來叫用完整的共用層級變更偵測。 Invoke-AzStorageSyncChangeDetection 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

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DirectoryPath

將執行變更偵測的目錄。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InputObject

CloudEndpoint 物件，通常是透過參數傳遞。

類型:	PSCloudEndpoint
別名:	CloudEndpoint
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

CloudEndpoint 的名稱。名稱是 GUID，不是入口網站中顯示的易記名稱。若要取得 CloudEndpointName，請使用 Get-AzStorageSyncCloudEndpoint Cmdlet。

類型:	String
別名:	CloudEndpointName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PassThru

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

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Path

將執行變更偵測的路徑。

類型:	String[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Recursive

指出目錄變更偵測是否遞歸。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源組名。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceId

CloudEndpoint 資源標識符

類型:	String
別名:	CloudEndpointId
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-StorageSyncServiceName

StorageSyncService 的名稱。

類型:	String
別名:	ParentName
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SyncGroupName

SyncGroup 的名稱。

類型:	String
Position:	2
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

PSServerEndpoint

輸出

Void

共用方式為