Dela via


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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DirectoryPath

Katalog där ändringsidentifiering ska utföras.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

CloudEndpoint Object, som normalt skickas via parametern.

Typ:PSCloudEndpoint
Alias:CloudEndpoint
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Alias:CloudEndpointName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

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

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Recursive

Ange om katalogändringsidentifieringen är rekursiv.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Namnet på resursgruppen.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceId

CloudEndpoint-resurs-ID

Typ:String
Alias:CloudEndpointId
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageSyncServiceName

Namnet på StorageSyncService.

Typ:String
Alias:ParentName
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SyncGroupName

Namnet på SyncGroup.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

PSServerEndpoint

Utdata

Void