New-SCADConnector
Skapar en ny Service Manager Active Directory-anslutningsapp.
Syntax
New-SCADConnector
[[-Description] <String>]
[-Enable <Boolean>]
[-DisplayName] <String>
[[-QueryRoot] <String>]
[-PassThru]
[-ComputerFilter <String>]
[-UserFilter <String>]
[-PrinterFilter <String>]
-ADCredential <PSCredential>
[[-RunAsAccount] <ManagementPackSecureReference>]
[-ScheduleDay <DaySchedule>]
[-ScheduleHour <Int32>]
[-SyncNow]
[-ExpandGroups]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdleten New-SCADConnector skapar en Service Manager Active Directory-anslutningsapp.
Följande parametrar är endast tillgängliga om du har tillämpat Service Manager 2012 R2 Samlad uppdatering 6 eller senare versioner.
- ScheduleDay
- ScheduleHour
Exempel
Exempel 1: Skapa en anslutningsapp till den lokala domänen
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow Account"
PS C:\> $Credential = Get-Credential
PS C:\> New-SCADConnector -DisplayName "Contoso AD Connector" -Description "Contoso AD Connector" -QueryRoot "LDAP://DC=Contoso,DC=com" -RunAsAccount $RunAsAccount -ADCredential $Credential -Enable $False -ScheduleDay Sunday -ScheduleHour 3
Det första kommandot hämtar ett Kör som-konto för arbetsflödeskontot med hjälp av cmdleten Get-SCSMRunAsAccount. Kommandot lagrar resultatet i variabeln $RunAsAccount.
Det andra kommandot uppmanar dig att ange autentiseringsuppgifter med hjälp av cmdleten Get-Credential och lagrar sedan autentiseringsuppgifterna i variabeln $Credential.
Det sista kommandot skapar en Active Directory-anslutning till den lokala domänen, som hämtar alla datorer, skrivare, användare och användargrupper. Anslutningsappen är konfigurerad för att synkroniseras varje söndag kl. 03:00
Exempel 2: Skapa en anslutningsapp till den lokala domänen som innehåller ett användarfilter
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow Account"
PS C:\> $Credential = Get-Credential
PS C:\> New-SCADConnector -DisplayName "Contoso AD Connector" -Description "Contoso users starting with E" -QueryRoot "LDAP://DC=Contoso,DC=com" -RunAsAccount $RunAsAccount -ADCredential $Credential -Enable $False -UserFilter "(givenname=E*)"
Det första kommandot hämtar ett Kör som-konto för arbetsflödeskontot och lagrar det sedan i variabeln $RunAsAccount.
Det andra kommandot uppmanar dig att ange autentiseringsuppgifter med hjälp av cmdleten Get-Credential och lagrar sedan autentiseringsuppgifterna i variabeln $Credential.
Det sista kommandot skapar en Active Directory-anslutning till den lokala domänen som endast hämtar de användarkonton som börjar med bokstaven E.
Parametrar
-ADCredential
Anger vilka autentiseringsuppgifter som ska användas när denna cmdlet ansluter till domänkontrollanten.
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerFilter
Anger ett filter som väljer de datorer som anslutningsappen synkroniserar.
Filtret måste anges som ett Active Directory-filter.
Följande filter innehåller till exempel alla datorer som börjar med win
i synkroniseringen:
(name=win*)
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Anger namnet på den dator där System Center Data Access-tjänsten körs. Det användarkonto som anges i parametern Autentiseringsuppgifter måste ha åtkomstbehörighet till den angivna datorn.
Type: | System.String[] |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Anger de autentiseringsuppgifter som denna cmdlet använder för att ansluta till servern där System Center Data Access-tjänsten körs. Det angivna användarkontot måste ha åtkomstbehörighet till den servern.
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Anger en beskrivning av anslutningsappen.
Type: | System.String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Anger egenskapen visningsnamn för anslutningsappen.
Type: | System.String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enable
Anger om denna cmdlet aktiverar eller inaktiverar anslutningsappen.
Type: | System.Boolean |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpandGroups
Anger att denna cmdlet rekursivt innehåller medlemmar i de grupper som anges av parametern UserFilter .
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Anger att denna cmdlet returnerar active directory-anslutningsappen som den skapar. Du kan skicka det här objektet till andra cmdletar.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrinterFilter
Anger ett filter som den här cmdleten använder för att välja de skrivare som anslutningsappen synkroniserar.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryRoot
Anger den Active Directory-mapp som denna cmdlet frågar efter objekt från, till exempel LDAP://DC=scsm,DC=stbtest,DC=microsoft,DC=com.
Type: | System.String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsAccount
Anger det RunAs-konto som ska användas när du använder den här anslutningsappen.
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
Position: | 3 |
Default value: | Operational System Account |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleDay
Anger den veckodag då anslutningsappen synkroniseras. Giltiga värden är:
- Varje dag
- Söndag
- Måndag
- Tisdag
- Onsdag
- Torsdag
- Fredag
- Lördag
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule |
Accepted values: | Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
Position: | Named |
Default value: | Daily |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleHour
Anger den timme då anslutningsappen startar synkroniseringen. Värdet måste vara ett tal från noll (0) till 23.
Type: | System.Int32 |
Position: | Named |
Default value: | 2 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
Anger ett objekt som representerar sessionen till en Service Manager hanteringsserver.
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SyncNow
Gör att Active Directory-anslutningsappen startar en synkroniseringscykel.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserFilter
Anger det filter som används för att välja användare till genom att synkroniseras med anslutningsappen.
Du måste ange värdet i form av ett Active Directory-filter.
Följande värde för den här parametern inkluderar till exempel i de synkroniseringsanvändare vars givenName börjar med a
:
(givenname=a*)
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
None.
Du kan inte skicka indata till denna cmdlet.
Utdata
None.
Denna cmdlet genererar inga utdata.