New-SCADConnector
Cria um novo conector do Active Directory do Service Manager.
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
O cmdlet New-SCADConnector cria um conector Service Manager Active Directory.
Os parâmetros a seguir só estarão disponíveis se você tiver aplicado Service Manager 2012 R2 Update Rollup 6 ou versões posteriores.
- ScheduleDay
- ScheduleHour
Exemplos
Exemplo 1: Criar um conector para o domínio local
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
O primeiro comando obtém uma conta Executar como para a Conta de Fluxo de Trabalho usando o cmdlet Get-SCSMRunAsAccount. O comando armazena o resultado na variável $RunAsAccount.
O segundo comando solicita credenciais usando o cmdlet Get-Credential e armazena as credenciais na variável $Credential.
O comando final cria um conector do Active Directory para o domínio local, que recupera todos os computadores, impressoras, usuários e grupos de usuários. O conector é configurado para sincronizar todos os domingos às 3:00 da manhã.
Exemplo 2: Criar um conector para o domínio local que inclui um filtro de usuário
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*)"
O primeiro comando obtém uma conta Executar como para a Conta de Fluxo de Trabalho e, em seguida, armazena-a na variável $RunAsAccount.
O segundo comando solicita credenciais usando o cmdlet Get-Credential e armazena as credenciais na variável $Credential.
O comando final cria um conector do Active Directory para o domínio local que recupera apenas as contas de usuário que começam com a letra E.
Parâmetros
-ADCredential
Especifica a credencial a ser usada quando esse cmdlet se conecta ao controlador de domínio.
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerFilter
Especifica um filtro que seleciona os computadores que o conector sincroniza.
O filtro deve ser especificado como um filtro do Active Directory.
Por exemplo, o filtro a seguir inclui todos os computadores que começam com win
na sincronização:
(name=win*)
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Especifica o nome do computador no qual o serviço de acesso a dados do System Center é executado. A conta de usuário especificada no parâmetro Credential deve ter direitos de acesso ao computador especificado.
Type: | System.String[] |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Especifica as credenciais que esse cmdlet usa para se conectar ao servidor no qual o serviço de Acesso a Dados do System Center é executado. A conta de usuário especificada deve ter direitos de acesso a esse servidor.
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifica uma descrição para o conector.
Type: | System.String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Especifica a propriedade de nome de exibição do conector.
Type: | System.String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enable
Indica se esse cmdlet habilita ou desabilita o conector.
Type: | System.Boolean |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpandGroups
Especifica que esse cmdlet inclui recursivamente membros dos grupos especificados pelo parâmetro UserFilter .
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Indica que esse cmdlet retorna o conector do Active Directory que ele cria. Você pode passar esse objeto para outros cmdlets.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrinterFilter
Especifica um filtro que esse cmdlet usa para selecionar as impressoras que o conector sincroniza.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryRoot
Especifica a pasta do Active Directory da qual esse cmdlet consulta objetos, como 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
Especifica a conta Executar como a ser usada ao utilizar esse conector.
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
Position: | 3 |
Default value: | Operational System Account |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleDay
Especifica o dia da semana em que o conector é sincronizado. Os valores válidos são:
- Diariamente
- Sunday
- Monday
- Terça-feira
- Quarta-feira
- Quinta-feira
- Friday
- Sábado
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
Especifica a hora em que o conector inicia a sincronização. O valor deve ser um número de zero (0) a 23.
Type: | System.Int32 |
Position: | Named |
Default value: | 2 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
Especifica um objeto que representa a sessão com um servidor de gerenciamento do Service Manager.
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SyncNow
Faz com que o conector do Active Directory inicie um ciclo de sincronização.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserFilter
Especifica o filtro que é usado para selecionar os usuários a serem sincronizados pelo conector.
Você deve especificar o valor na forma de um filtro do Active Directory.
Por exemplo, o valor a seguir para esse parâmetro inclui os usuários de sincronização cujo givenName começa com a
:
(givenname=a*)
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None.
Não é possível redirecionar a entrada para este cmdlet.
Saídas
None.
Este cmdlet não gera saída.