Dela via

Invoke-AzStorageSyncChangeDetection

Modul:
Az.StorageSync Module

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å.

Anmärkning

Om du kör med -DirectoryPath eller -Path parametrar identifieras 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

FullShareStringParameterSet (Standard) 

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

StringAndDirectoryParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

StringAndPathParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceGroupName] <String>
    [-StorageSyncServiceName] <String>
    [-SyncGroupName] <String>
    -Name <String>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdAndDirectoryParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdAndPathParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullShareResourceIdParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-ResourceId] <String>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectAndDirectoryParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-InputObject] <PSCloudEndpoint>
    -DirectoryPath <String>
    [-Recursive]
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectAndPathParameterSet 

Invoke-AzStorageSyncChangeDetection
    [-InputObject] <PSCloudEndpoint>
    -Path <String[]>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FullShareObjectParameterSet 

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DirectoryPath

Katalog där ändringsidentifiering ska utföras.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

StringAndDirectoryParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ResourceIdAndDirectoryParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ObjectAndDirectoryParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-InputObject

CloudEndpoint Object, som normalt skickas via parametern.

Parameteregenskaper

Typ:PSCloudEndpoint
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:CloudEndpoint

Parameteruppsättningar

ObjectAndDirectoryParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ObjectAndPathParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
FullShareObjectParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:CloudEndpointName

Parameteruppsättningar

FullShareStringParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
StringAndDirectoryParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
StringAndPathParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Path

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

StringAndPathParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ResourceIdAndPathParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ObjectAndPathParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Recursive

Ange om katalogändringsidentifieringen är rekursiv.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

StringAndDirectoryParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ResourceIdAndDirectoryParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ObjectAndDirectoryParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ResourceGroupName

Namn på resursgrupp.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

FullShareStringParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
StringAndDirectoryParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
StringAndPathParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ResourceId

CloudEndpoint-resurs-ID

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:CloudEndpointId

Parameteruppsättningar

ResourceIdAndDirectoryParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ResourceIdAndPathParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
FullShareResourceIdParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-StorageSyncServiceName

Namnet på StorageSyncService.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ParentName

Parameteruppsättningar

FullShareStringParameterSet
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
StringAndDirectoryParameterSet
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
StringAndPathParameterSet
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SyncGroupName

Namnet på SyncGroup.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

FullShareStringParameterSet
Position:2
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
StringAndDirectoryParameterSet
Position:2
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
StringAndPathParameterSet
Position:2
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

PSServerEndpoint

Utdata

Void