Invoke-AzStorageSyncChangeDetection

Reference

Modul:: Az.StorageSync

Tento příkaz lze použít k ručnímu zahájení detekce změn oboru názvů. Může být cílená na celou sdílenou složku, podsložku nebo sadu souborů. Při spuštění příkazu s parametry -DirectoryPath nebo -Path lze zjistit maximálně 10 000 položek. Pokud je rozsah změn známý, omezte provádění tohoto příkazu na části oboru názvů, takže detekce změn se může rychle dokončit a v rámci limitu 10 000 položek. Případně se můžete vyhnout limitu položek spuštěním rutiny bez těchto parametrů a vyvoláním detekce změn na úrovni sdílení.

Poznámka

Pokud se spustí s parametry -DirectoryPath nebo -Path, příkaz nezjistí následující změny ve sdílené složce Azure:

Soubory, které jsou odstraněny.
Soubory, které jsou přesunuty ze sdílené složky.
Soubory, které se odstraní a vytvoří se stejným názvem.

Pokud se vyvolá detekce změn na úrovni sdílené složky, všechny tyto změny se detekují. Tyto změny se také zjistí při spuštění naplánované úlohy detekce změn .

Syntaxe

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

Synchronizace souborů Azure pravidelně kontroluje obor názvů v synchronizační sdílené složce Azure a zjišťuje změny, které se do sdílené složky dostaly jiným způsobem, než je synchronizace. Cílem je identifikovat tyto změny a nakonec je synchronizovat s připojenými servery. Tento příkaz lze použít k ručnímu zahájení detekce změn oborů názvů. Může být cílená na celou sdílenou složku, podsložku nebo sadu souborů. Pokud znáte rozsah změn, omezte provádění tohoto příkazu na části oboru názvů, aby detekce změn jednotlivých položek byla dokončena rychle a v rámci limitu 10 000 položek. V opačném případě spusťte příkaz bez parametrů -DirectoryPath nebo -Path, aby se vyvolala detekce změn na úrovni sdílené složky. Rutina Invoke-AzStorageSyncChangeDetection zruší probíhající úlohu výčtu změn cloudu. Pokud se chcete vyhnout zrušení aktuálně spuštěné úlohy, přejděte na portálu do vlastností koncového bodu cloudu a zkontrolujte, jestli je úloha aktuálně spuštěná.

Příklady

Příklad 1

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

V tomto příkladu se detekce změn spouští v adresářích Data a Reporting\Templates synchronizační sdílené složky Azure. Všechny cesty jsou relativní ke kořenovému adresáři oboru názvů sdílené složky Azure.

Příklad 2

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

V tomto příkladu se detekce změn spouští pro sadu souborů, které jsou známé volajícímu příkazu, že se změnily. Cílem je, aby synchronizace souborů Azure rozpoznala a synchronizovala i tyto změny.

Příklad 3

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

V tomto příkladu je detekce změn spuštěna pro adresář "Příklady" a rekurzivně rozpozná změny v podadresářích. Nezapomeňte, že rutina selže, pokud cesta obsahuje více než 10 000 položek. Pokud cesta obsahuje více než 10 000 položek, spusťte příkaz v dílčích částech oboru názvů.

Příklad 4

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

V tomto příkladu se příkaz nepředá ani -Path ani -DirectoryPath. Tím se vyvolá detekce změn v celé sdílené složce.

Parametry

-AsJob

Spuštění rutiny na pozadí

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DirectoryPath

Adresář, kde se provede detekce změn.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

CloudEndpoint Object, obvykle předán prostřednictvím parametru.

Typ:	PSCloudEndpoint
Aliasy:	CloudEndpoint
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Název CloudEndpointu Název je identifikátor GUID, nikoli popisný název, který se zobrazuje na portálu. Pokud chcete získat CloudEndpointName, použijte rutinu Get-AzStorageSyncCloudEndpoint.

Typ:	String
Aliasy:	CloudEndpointName
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PassThru

V normálním spuštění tato rutina nevrací žádnou hodnotu při úspěchu. Pokud zadáte parametr PassThru, rutina po úspěšném spuštění zapíše hodnotu do kanálu.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Path

Cesta, kde se provede detekce změn.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Recursive

Indikuje, jestli je detekce změn adresáře rekurzivní.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Název skupiny prostředků

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceId

ID prostředku CloudEndpoint

Typ:	String
Aliasy:	CloudEndpointId
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageSyncServiceName

Název služby StorageSyncService.

Typ:	String
Aliasy:	ParentName
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SyncGroupName

Název skupiny SyncGroup.

Typ:	String
Position:	2
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

PSServerEndpoint

Výstupy

Void

Sdílet prostřednictvím