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

Vstupy

String

PSServerEndpoint

Výstupy

Void