Invoke-AzStorageSyncChangeDetection

Det här kommandot kan användas för att manuellt initiera identifiering av namnområdesändringar. Den kan riktas mot hela resursen, undermappen eller uppsättningen filer. När du kör kommandot med parametrarna -DirectoryPath eller -Path kan högst 10 000 objekt identifieras. Om omfånget för ändringar är känt för dig begränsar du körningen av det här kommandot till delar av namnområdet, så att ändringsidentifieringen kan slutföras snabbt och inom gränsen på 10 000 objekt. Du kan också undvika objektgränsen genom att köra cmdleten utan dessa parametrar och anropa ändringsidentifiering på resursnivå.

Kommentar

Om du kör med parametrarna -DirectoryPath eller -Path identifierar kommandot inte följande ändringar i Azure-filresursen:

  • Filer som tas bort.
  • Filer som flyttas från resursen.
  • Filer som tas bort och skapas med samma namn.

Om ändringsidentifiering på resursnivå anropas identifieras alla dessa ändringar. Dessa ändringar identifieras också när det schemalagda ändringsidentifieringsjobbet körs.

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

Med jämna mellanrum kontrollerar Azure File Sync namnområdet i en synkroniserande Azure-filresurs efter ändringar som kom in i filresursen på annat sätt än synkronisering. Målet är att identifiera dessa ändringar och slutligen synkronisera dem till anslutna servrar. Det här kommandot kan användas för att manuellt initiera identifieringen av namnrymdsändringar. Den kan riktas mot hela resursen, undermappen eller uppsättningen filer. Om omfånget för ändringar är känt för dig begränsar du körningen av det här kommandot till delar av namnområdet, så att identifieringen av enskilda objektändringar kan slutföras snabbt och inom gränsen på 10 000 objekt. Annars kör du kommandot utan parametrarna -DirectoryPath eller -Path för att anropa fullständig ändringsidentifiering på resursnivå. Cmdleten Invoke-AzStorageSyncChangeDetection avbryter ett uppräkningsjobb för molnändringar som pågår. Om du vill undvika att avbryta ett jobb som körs går du till egenskaperna för molnslutpunkten i portalen för att kontrollera om ett jobb körs för närvarande.

Exempel

Exempel 1

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

I det här exemplet körs ändringsidentifiering i katalogerna "Data" och "Reporting\Templates" för en synkroniserande Azure-filresurs. Alla sökvägar är relativa till roten för Azure-filresursens namnområde.

Exempel 2

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

I det här exemplet körs ändringsidentifiering för en uppsättning filer som är kända för att kommandoanroparen ska ha ändrats. Målet är att azure-filsynkronisering även ska identifiera och synkronisera dessa ändringar.

Exempel 3

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

I det här exemplet körs ändringsidentifiering för katalogen "Exempel" och identifierar rekursivt ändringar i underkataloger. Kom ihåg att cmdleten misslyckas om sökvägen innehåller mer än 10 000 objekt. Om sökvägen innehåller fler än 10 000 objekt kör du kommandot på underdelar av namnområdet.

Exempel 4

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

I det här exemplet har varken -DirectoryPath eller -Path skickats till kommandot. Detta anropar ändringsidentifiering för hela filresursen.

Parametrar

-AsJob

Kör cmdlet i bakgrunden

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DirectoryPath

Katalog där ändringsidentifiering ska utföras.

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

-InputObject

CloudEndpoint Object, som normalt skickas via parametern.

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

-Name

Namnet på CloudEndpoint. Namnet är ett GUID, inte det eget namn som visas i portalen. Om du vill hämta CloudEndpointName använder du cmdleten Get-AzStorageSyncCloudEndpoint.

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

-PassThru

Vid normal körning returnerar den här cmdleten inget värde vid lyckad körning. Om du anger parametern PassThru skriver cmdleten ett värde till pipelinen efter att körningen har slutförts.

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

-Path

Sökväg där ändringsidentifiering utförs.

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

-Recursive

Ange om katalogändringsidentifieringen är rekursiv.

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

-ResourceGroupName

Namnet på resursgruppen.

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

-ResourceId

CloudEndpoint-resurs-ID

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

-StorageSyncServiceName

Namnet på StorageSyncService.

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

-SyncGroupName

Namnet på SyncGroup.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

PSServerEndpoint

Utdata

Void