Invoke-AzStorageSyncChangeDetection
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 spustíte parametry -DirectoryPath nebo -Path, příkaz nerozpozná 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.
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
Pravidelně Synchronizace souborů Azure kontroluje obor názvů uvnitř synchronizační sdílené složky Azure, jestli se změny, které se do sdílené složky dostaly, jinými prostředky než 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 pro vyvolání úplné detekce změn na úrovni sdílené složky. Rutina Invoke-AzStorageSyncChangeDetection zruší probíhající úlohu výčtu změn v 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 nebyl do příkazu předán parametr -DirectoryPath ani -Path. Tím se vyvolá detekce změn v celé sdílené složce.
Parametry
-AsJob
Spuštění rutiny na pozadí
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DirectoryPath
Adresář, kde se provede detekce změn.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
CloudEndpoint Object, obvykle předán prostřednictvím parametru.
Type: | PSCloudEndpoint |
Aliases: | CloudEndpoint |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | CloudEndpointName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Cesta, kde se provede detekce změn.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Recursive
Indikuje, jestli je detekce změn adresáře rekurzivní.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Název skupiny prostředků
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
ID prostředku CloudEndpoint
Type: | String |
Aliases: | CloudEndpointId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageSyncServiceName
Název služby StorageSyncService.
Type: | String |
Aliases: | ParentName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SyncGroupName
Název skupiny SyncGroup.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |